SIEMENS 
€ 


TRANSDATA 


DCAM 
Programmschnittstellen 


Beschreibung 


Ausgabe Januar 1985 
Softwareprodukt DCAM V8.0A (BS2000) 


TRANSDATA 


DCAM 
Programmschnittstellen 


Beschreibung 


© Ausgabe Januar 1985 
-Softwareprodukt DCAM V8.0A (BS2000) 


Bestell-Nr. U1786-J-Z75-1 
Printed in the Federal Republic of Germany 


1330 AG 10850.8 (1660) 


Vervielfältigung dieser Unterlage sowie Verwertung ihres 

Inhalts unzulässig, soweit nicht ausdrücklich zugestanden. 

Im Laufe der Entwicklung des Produktes können aus 
technischen oder wirtschaftlichen Gründen Leistungsmerkmale 
hinzugefügt bzw. geändert werden oder entfallen. 
Entsprechendes gilt für andere Angaben in dieser Druckschrift. 


Siemens Aktiengesellschaft 


Vorwort 


Diese Beschreibung der DCAM (Data Communication Access Method)-Programmschnittstel- 
len wendet sich an verschiedene Adressaten: 


— Organisatoren und Einsatzplaner, die sich eine Übersicht über Umfang und Leistungsfä- 
higkeit der Schnittstelle verschaffen wollen. 


— Programmierer (Assembler, COBOL), die hier grundlegendes Wissen erwerben können, 
um im jeweiligen Programmierhandbuch weitere Details zu verstehen und anzuwenden. 


— Systemverwalter und Netzadministratoren, die keine speziellen Kenntnisse der Schnitt- 
stelle benötigen, jedoch ein allgemeines Wissen über DCAM erwerben möchten. 


Die Adressaten sollten zuvor möglichst praktisch und theoretisch mit dem BS2000 vertraut 
sein. Soweit sie DCAM anwenden wollen, ist auch die Kenntnis von Assembler oder COBOL 
vorausgesetzt. 


Gegliedert ist diese Beschreibung in vier Teile: 
1. Einbettung von DCAM in das BS2000, Leistungsumfang und bediente Hardware; 


2. Erläuterung grundlegender Begriffe und Überlegungen zur Planung von Programmen 
oder Programmsystemen; 


3. Beschreibung der Funktionen aller DCAM-Aufrufe und Meldungen, bezogen auf die 
Existenz der DCAM-Anwendung logische Verbindung, Datenübermittlung; 


4. Überblick über die Codierung von DCAM-Programmen in Assembler und COBOL, ferner 
über die Ausführung solcher Programme. 


Kapitel 1 und 2 sind für die allgemeine Einführung, Übersicht, Programmplanung und 
Organisation wichtig. Kapitel 3 ist wegen der umfassenden Beschreibung aller Funktionen für 
alle Benutzer geeignet, die nähere Informationen benötigen. Kapitel 4 soll besonders dem 
Einsatzplaner dienen; dem Programmierer dient es als Überleitung zur Benutzung des 
jeweiligen Programmierhandbuchs. Der Aufbau des dritten Kapitels ist identisch mit den 
dritten Kapiteln in den Benutzerhandbüchern für Assembler und COBOL. Damit soll bei deren 
Benutzung ein leichter Rückgriff auf die Funktionsbeschreibung ermöglicht werden. 


Da zahlreiche Begriffe neu eingeführt wurden, ist eine Erläuterung der TRANSDATA-Begriffe 
angefügt. Das Literatur- und Stichwortverzeichnis soll bei der Orientierung hilfreich sein. 


Das vorliegende Manual ist Teil der Gesamtbeschreibung der Kommunikations-Zugriffsme- 
thode DCAM. Thematisch zugeordnet sind ihm einerseits Informationsschriften über Rech- 
nernetze, Datenfernverarbeitung mit BS2000 und eine Kurzbeschreibung von TRANSDATA 
DCM, andererseits die Benutzerhandbücher "DCAM-Makroaufrufe” und "DCAM-COBOL- 
Aufrufe”. Für Generierung und Administration steht ein eigenes Manual zur Verfügung; zur 
Programmierung der Kommunikationsrechner und der Datenstationen ebenfalls. 


Die Neuerungen gegenüber dem Vorgängermanual sind auf dem Änderungsprotokoll 1 
zusammengefaßt. 


Literaturhinweise werden im Text in Kurztiteln angegeben. Der vollständige Titel jeder 
Druckschrift, auf die verwiesen wird, ist im Literaturverzeichnis aufgeführt. Daran anschlie- 
Rend finden Sie Hinweise zur Bestellung von Druckschriften. 


Bitte unterstützen Sie uns, dieses Manual zu verbessern. Für Ihre Anregungen verwenden Sie 
bitte das rosa Formblatt am Ende des Manuals. 


Manualredaktion DSTPM2 
Otto-Hahn-Ring 6, 8 München 83 
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Anderungsprotokoll 1 


Änderungen des Vorgängermanuals, 


Stand Oktober 1982 (DCAM V7.0) 
durch die Neuausgabe vom 

Januar 1985 (DCAM V8.0) 
Seite Änderung 


2-13, 3-11, 3-17 (Bild 3-10) l 
Auch bei Annahme einer Verbindung kann die Anwendung dem Partner eine 
Verbindungsnachricht zukommen lassen. 


2-11, 3-13, 3-25 
Nach Überlastung einer Verbindung kann ein Go-Signal zugestellt werden 
(SIGNAL). 

3-13 Angabe der maximalen Länge der zu sendenden Daten (MAXLN) für Optimierung 


der Systempuffer. 


3-2, 3-5 
Beim Eröffnen einer DCAM-Anwendung muß DCAMVER angegeben werden, falls 
bestimmte neue Funktionen der Version eingesetzt werden sollen. 


3-14 (Bild 3-8) 
Neue Möglichkeiten der Nachrichtenaufbereitung: EXTEND, NLOGC, LACK 


2-9, 2-11, 3-2, 3-3, 3-5, 3-27, 3-30 
Die Einschränkung, daß unter COBOL asynchrone Meldungen nicht verarbeitet 
werden, entfällt. 
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1.1 


DCAM im Datenkommunikationssystem TRANSDATA 
(Allgemeine Einführung) 


Innerhalb des Datenkommunikationssystems TRANSDATA haben Zugriffsmethoden, wie z.B. 
auch DCAM an der Schnittstelle nach ‘drauRen’, zum Benutzer hin, ihren Platz. DCAM bietet 
dem Anwender alle Möglichkeiten von TRANSDATA an seiner Programmschnittstelle. Dabei 
ist DCAM mit allen weiteren Zugriffsmethoden des BS2000 eingebettet in das Zugriffssystem 
für Datenkommunikation TRANSDATA DCM (Data Communication Methods). 


Das Kommunikations-Zugriffssystem TRANSDATA DCM 


Seit Version 4 des BS2000 wird der Zugriff zum Datenkommunikationssystem über eine 
einheitliche Komponente des Systems ermöglicht. Sie ist wie die Komponenten von TRANS- 
DATA, in mehrere Schichten strukturiert. Dadurch ergeben sich saubere Schnittstellen, sodaß 
spätere Änderungen der Hardwarekonfiguration oder auch der Systemsoftware nicht die 
Benutzerschnittstelle betreffen. Der Benutzer wird künftige Entwicklungen, die weitere Vor- 
teile bringen, nicht mit erhöhtem Umstellungsaufwand erkaufen müssen. 

TRANSDATA DCM bietet ihm heute: 


e Zugriffsmethode DCAM zur Lösung der Aufgaben des Teilhaberbetriebs; 


e Unterstützung bei der Programmierung der Datenstationen durch den Einsatz Logischer 
Datenstationen; 


e Administration an wahlfreien Bedienplätzen, auch wenn gewünscht, in einem DCAM- 
Programm unter Verwendung des Bausteins für Mehrkonsolbetrieb (UCON); 


e Leistungsfähige Unterstützung der bekannten Schnittstellen für Teilnehmberbetrieb 
(RTIO) und Stapelfernverarbeitung (RBP). 


Dieser Komfort der Benutzerschnittstelle wird ermöglicht durch die Bausteine, die in TRANS- 
DATA für den Benutzerservice geschaffen wurden: 


e DCAM (data communication access method) für die Realisierung der DCAM-Schnitt- 
stelle in Assembler und COBOL 


e VTSU (virtual terminal support) für die Realisierung der Logischen Datenstationen 


e TIAM (terminal interactive access method) für die Realisierung der RTIO-Assembler- 
Schnittstelle (remote terminal input output) 


e RBAM (remote batch access method) für die Unterstützung des Stapelbetriebs mit RBP 
(remote batch processing) - Kommandos. 


Die erwähnten Bausteine haben ihrerseits eine definierte Schnittstelle zu BCAM (basic 
communication access method). In diesem Basis-Baustein wurden die allen Zugriffsmetho- 
den gemeinsamen Aufgaben wie Transportsteuerung, Zwischenspeicherung, Bedienung des 
Kanalanschlusses zum Datenübertragungsvorrechner, usw. realisiert. 
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Bild 1-1 zeigt in einem Uberblick die Komponenten von TRANSDATA DCM. 


Dem Benutzer von DCAM erschließen sich die vielfältigen Möglichkeiten des Datenkommuni- 
kationssystems insbesondere in Bezug auf freizügigen Datenverkehr mit allen Kommunikati- 
onspartnern (Anwendungen und Datenstationen). 


Schnittstellen Schnittstelle Schnittstelle 
zu einem weiteren zum Datenüber- zu lokal 
. Verarbeitungsrechner tragungsvorrechner angeschlossenen 
über eine Daten- Modell 968x Datenstationen 
austauschsteuerung über Mehrfachsteuerung 8170 


Bild 1-1 Aufbau von TRANSDATA DCM 
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1.2 Verkehrsbeziehungen im Datenkommunikationssystem mit DCAM 1 


DCAM erlaubt die Kommunikation von einem oder mehreren Prozessen (Programmen) im 
Verarbeitungsrechner mit einer Datenstation oder einer Vielzahl von Datenstationen. Dies 
wäre die klassische Verkehrsbeziehung, wie sie auch früher schon üblich war bei Konzentrie- 
rung der Verarbeitungsleistung auf einen Rechner in einem sternförmigen Netz. DCAM 
unterstützt aber auch das Prinzip der verteilten Verarbeitungsleistung durch Rechner-Rech- 
ner-Verkehr. Prozesse (Programme) eines Rechners können mit Prozessen (Programmen) 
eines anderen Rechners kommunizieren. Darüberhinaus können auch Prozesse (Programme) 
im selben Verarbeitungsrechner über DCAM Datenkommunikation betreiben. Dies ist insbe- 
sondere für die Testphase von solchen Programmen wichtig, denn es können Datenstationen 
ohne weiteres durch Programme simuliert werden. Die Verkehrsbeziehungen werden in Bild 
1-2 gezeigt. 


Innerhalb des eigenen Rechners ist auch der Zugriff auf die Systemanwendung ‘$CONSOLE’ 
möglich, sodaß Bedienung und Administration des Systems von einem Programm aus 
möglich wird. Werden die entsprechenden Kommandos von einer Datenstation an dieses 
Programm gegeben, kann es diese zur Ausführung an '$CONSOLE’ (Anwendung für Mehr- 
konsolbedienung) weiterreichen. Damit wird Bedienung und Administration über eine Daten- 
station ermöglicht. 


Das Modell für ein solches Programm wird in DCAM-COBOL-Aufrufe, Kapitel 4, gezeigt. Die 
weitere Erläuterung zu dem Thema ist den Manualen Bedienungsanleitung und Generierung 
und Administration zu entnehmen. 


Neue Verkehrsbeziehungen sind möglich geworden durch ein erweitertes Hardwarespektrum, 
das vom BS2000 ab Version 4 bedient wird. 
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Datenkommuni- 
kationssystem 
TRANSDATA 


= Verarbeitungs- 


1 Anwendung - mehrere Prozesse 


Stationen: Anwendung (Gruppen-Anwendung) 


1 Anwendung - 1 Prozeß 
Datenstation LJ (Einfach-Anwendung) 


Verbindungen: 


logische Verbindung Aktivitäten: @) Prozeß 


Bild 1-2 Von DCAM unterstützte Verkehrsbeziehungen 
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1.3 Hardwarespektrum fiir den Einsatz von DCAM 


Das BS2000 der Version 6 erlaubt den Einsatz einer groRen Anzahl leistungsfahiger Hardware- 
bausteine im Datenkommunikationssystem TRANSDATA. Bild 1-3 zeigt in einem Uberblick 
alle einsatzbaren Geräte. Neu bedient werden aus der TRANSDATA-Rechnerfamilie die 
Datenstationsrechner 966x. 


Erstmals wird die Mehrfachsteuerung für Nahanschluß 8170 eingesetzt. Sie ermöglicht den 
Anschluß von Datenstationen direkt an den Verarbeitungsrechner. 
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1-6 


Bild 1-3 


Hardware-Struktur von TRANSDATA mit BS2000 
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VAR = Verarbeitungsrechner 

DAST = Datenaustauschsteuerung 4627 

DVR = Datenübertragungsvorrechner Modelle 968x 
NKR = Netzknotenrechner Modelle 967x 

DSR = Datenstationsrechner Modelle 966x 


Kanalschluß 
Direktanschluß oder Datenübertragungsleitung 
Doppelsystem-Umschalteinheit alternativer Anschluß 


Mehrfachsteuerung für Fernanschluß 8171 


) 

) 

) 

) 

5)  Schnittstellen-Vervielfacher 8906 
) Konzentrator-Mittelschnell 8901 

)  Konzentrator-Mittelschnell 8902 

) Konzentrator-Mittelschnell 8903 

) Standverbindung 

Verbindung über Wahlamt (TELEX, DATEX, Fernsprechnetz) 
Mehrfachsteuerung für Nahanschluß 8170 

Lokalring 

Abgesetzter Lokalring 


Mehrpunktnetze mittels Datenübertragungseinrichtung (Modem N10) 


O Datenstation (einschl. TRANSDATA 810) 
X nur Datenstationssystem TRANSDATA 810 
Die Ziffer gibt jeweils die maximale Anzahl der Anschlusse an. 


Systeme 7.500 


System TRANSDATA 960 
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Bei der Programmierung der Datenstationen wird der Benutzer, wie schon erwahnt, durch die 
logischen Datenstationen (siehe 2.3.4) unterstützt. Für welche Geräte dies zutrifft, ist aus Bild 
1-4 zu ersehen. 


Logische Datenstationen 


Zeilen-Datenstation Format-Datenstation 


VTSU Unterstützung der logischen Datenstationen 
Virtual Terminal Support 


Schreibstation 


Datensichtstation 


Modellnummern der tatsächlichen Datenstationen 


8103 81503) 81604) 
8110") 81513) 81614) 
81212) 81523) 81624 
81222) 81533) 975x°) 
1) wird als Format- Hardcopy-Zusatzgeräte 
datenstation 3) 8100, 8120 
nicht bedient. 


2) anschließb 4) 8121, 8122,9002,9003 
über 8112 j 59001,9004 


Bild 1-4 Unterstützung durch logische Datenstationen 
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2.1 


Grundbegriffe und Einführung in die Verwendung der 
DCAM-Schnittstelle 


DCAM-Programme unterscheiden sich von anderen nicht nur durch die Verwendung der 
DCAM-Schnittstelle. Der Zugriff zum Datenkommunikationssystem TRANSDATA bestimmt 
darüber hinaus ihren Aufbau. Darum ist es Aufgabe dieses Kapitels, die Fragen zu beantwor- 
ten: 


e Welche Merkmale bestimmen die Leistungsfähigkeit der DCAM-Schnittstelle? 

e Wie ist die Grundstruktur eines DCAM-Programms? 

e Welche Punkte sind bei der Planung eines DCAM-Programms zu beachten? 

Vorher jedoch werden einige Grundbegriffe erläutert, die für das Verständnis wichtig sind: 
e Programm, Daten, Prozeß 

e Kommunikationspartner 

e Symbolische Adressierung 


e Logische Verbindung 


Grundlegende Begriffe 


Programm, Daten, Prozeß 


Im BS2000 wird in der Regel der Programm- und Datenspeicher (Datenspeicher= Datenbe- 
reich im Programm), sowie der vom Programm gesteuerte Prozeß als Einheit verwaltet. In den 
folgenden Ausführungen wird darum der Übersichtlichkeit halber auf die Unterscheidung 
dieser drei Komponenten verzichtet. So ist diese Einheit immer angesprochen, wenn von 
Programm oder Prozeß die Rede ist. Für das Senden und Empfangen von Nachrichten ist der 
prozeßspezifische Datenspeicher von Bedeutung, da von ihm übertragen oder in ihn übertra- 
gen wird. Darum wird auch eigens vom Datenspeicher an einigen Stellen gesprochen. 

Den spezifischen Eigenschaften eines DCAM-Programms, seinem Aufbau und seiner Organi- 
sation, ist ein eigener Abschnitt gewidmet (2.3). 

In einem anderen Abschnitt wird auch darauf eingegangen, welche besondere Situation 
entsteht, wenn ein Programm mehrere Prozesse steuert (sharable programs/moduls) (siehe 
4.1.6). 

Die Programmausführung, der DCAM-Prozeß, ist ebenfalls in einem eigenen Abschnitt 
beschrieben (siehe 4.1.6; ferner Bild 2-1). 


Bild 2-1 Der Prozeß als Verwaltungseinheit im BS2000 
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2.1.2 


Kommunikationspartner 


Im Datenkommunikationssystem TRANSDATA gibt es 2 unterschiedliche Typen von Kommu- 
nikationspartnern: 


Datenstationen und Anwendungen. Anwendungen können sein: 


— DCAM-Anwendungen, 
— UTM-Anwendungen, 
— PDN-Anwendungen. 


Auf Existenz des Kommunikationspartners Datenstation hat der Programmierer keinen Ein- 
flu&. Dieser Kommunikationspartner wird entweder bei der Generierung des Kommunikati- 
onssystems oder durch Administrationsbefehle des Netzadministrators erzeugt und aufge- 
lost. 


Die Erzeugung des Kommunikationspartners DCAM-Anwendung ist eine Funktion der DCAM- 
Schnittstelle. 


Im weiteren Sinn werden alle Teilnehmer des Datenkommunikationssystems TRANSDATA 
Kommunikationspartner genannt, die logische Verbindungen zu anderen Partnern aufbauen 
können. Im engeren Sinne werden mit diesem Namen die beiden Partner einer bestehenden 
logischen Verbindung bezeichnet. 


Eine Datenstation ist gekennzeichnet durch ihre technische Realisierung einerseits und die 
sie bedienende Person. Das Zusammenwirken von Gerät und Benutzer des Geräts, ergeben zu 
einem jeweilig bestimmten Zeitpunkt den Kommunikationspartner Datenstation. Dieser kann 
nur mit den Mitteln des Datenkommunikationssystems logische Verbindung zu anderen 
Partnern unterhalten und über diese Verbindungen Daten senden und empfangen. 


Eine DCAM-Anwendung existiert ausschließlich in einem vom BS2000 gesteuerten Verarbei- 
tungsrechner. Sie wird in mindestens einem DCAM-Programm definiert und durch die 
Kommunikations-Zugriffsmethode erzeugt. Als adressierbare Einheit für eingehende und zu 
sendende Nachrichten, bzw. Meldungen wird sie vom Kommunikations-Zugriffssystem ver- 
waltet und auf Anforderung des Programms wieder aufgelöst. Sie ist die Adresse, unter der 
Prozesse (Programme) oder Gruppen von Prozessen dem Datenkommunkationssystem 
gegenüber bekannt sind. Sie werden damit zu Kommunikationspartnern. 


Eine DCAM-Anwendung kann von einem Prozeß eröffnet werden (einfach benutzbar) oder 
von mehreren, einer Prozeßgruppe (mehrfach benutzbar). Der erste eröffnende Prozeß ist 
der Primärprozeß. Sekundärprozesse können sich anschließen, wenn dies vorgesehen ist. In 
einem Programm können mehrere DCAM-Anwendungen eröffnet werden. Diese können 
isoliert, jede für sich betrachtet werden, darum wird diese Möglichkeit in der Beschreibung, 
die hier vorliegt, nicht weiter behandelt. Mit der Erzeugung der DCAM-Anwendung wird ihr 
Name festgelegt (siehe Beispiel in Bild 2-2). 


Dieser Name kann von System dynamisch erzeugt werden, oder es kann ein vordefinierter 
und dem Kommunikationssystem bekannter Name verwendet werden. Der Name der DCAM- 
Anwendung muß in dem Verarbeitungsrechner, in dem die DCAM-Anwendung erzeugt wird, 
eindeutig sein. 


Die Kommunikation mit anderen Anwendungen im Verarbeitungsverbund beschreibt 2.3.5. 
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2.1.3 


Einfach benutzbare DCAM-Anwendungen 
(können nur von einem Prozeß eröffnet werden). 


Mehrfach benutzbare DCAM-Anwendungen 
(können von mehreren Prozessen eröffnet werden) 


*) Prozeß hat mehrere Anwendungen eröffnet 


Bild 2-2 Beispiele für DCAM-Anwendungen 


Symbolische Adressierung 


Um einen Partner zu adressieren genügen zwei Namen: Der Name des Prozessorknotens, an 
dem der Partner als Station angeschlossen ist und der Name des Kommunikationspartners 
selbst (siehe Erläuterung der TRANSDATA-Begriffe). 


Die Namen der Datenstation und Prozessorknoten werden bei der Generierung des Daten- 
kommunikationssystems festgelegt. Die Namen der DCAM-Anwendungen können bei deren 
Eröffnung im Programm festgelegt werden. In bestimmten Fällen können sie auch dynamisch 
im System erzeugt werden (siehe auch Bild 2-3). Die symbolischen Adressen werden 
innerhalb des Datenkommunikationssystems stufenweise umgesetzt. So entsteht eine Stufe 
tiefer die logische Netzadresse und weiter die physikalische Adresse des Gerätes. Der 
Benutzer von DCAM braucht aber nur die symbolischen Adressen zu kennen. Alle verwende- 
ten Namen können maximal 8 Zeichen lang sein. Das erste Zeichen muß alphabetisch sein 
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Fi 
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oder gleich $, @, #. Das 2. bis 8. Zeichen kann zusätzlich aus den Ziffern 0...9 bestehen 
(Assembler-Namenskonvention). Der Name einer Anwendung des Benutzers darf nicht mit 
dem Dollarzeichen '$’ beginnen, da es für systeminterne Anwendungen reserviert ist. 


Verarbeitungsrechner mit BS2000 


| Daten- | 
kommunika- : 
tionssystem | . 


nn Dateniibertragungsvorr 


zu weiteren 
Kommunika- 
ow 


Anschlüsse § X 


Datenstation Datenstation Datenstation Datenstation Datenstation 


Bild 2-3 Beispiel für Netzkonfiguration mit symbolischen Adressen. MSR Hii 
artnernamen 


Le | Prozessornamen 
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2.1.4 


Logische Verbindung 


Bevor Datenubermittlung Uber das Datenkommunikationssystem realisiert werden kann, 
mussen jeweils die beiden Kommunikationspartner eine Absprache getroffen haben. Diese 


Absprache wird erreicht, indem zwei Kommunikationspartner erklären, daß sie sich Daten 


übermitteln wollen. Ein Partner beginnt mit einer Aufforderung zum Verbindungsaufbau 
(acquisition), der andere kann mit einer Annahme reagieren (acceptance) und bewirkt so den 
Verbindungsaufbau im Datenkommunikationssystem. Dabei werden die Modalitäten der 
Datenübertragung festgelegt (wie z.B. die Verwendung ‘Logischer Datenstation’). Logische 
Verbindungen können bestehen zwischen einer Datenstation und einer DCAM-Anwendung 
und zwischen zwei DCAM-Anwendungen (siehe auch Bild 2-4). 


Einer logischen Verbindung werden im Datenkommunikationssystem 
e eine Route im Netz, 

e Zwischenspeicherbereiche, usw. 

zugeordnet. 


Die logische Verbindung zwischen zwei Kommunikationspartnern wird in den betroffenen 
Netzkomponenten dokumentiert. 
Deshalb wird die Sicherheit der Datenübermittlung in einen hohem Maße garantiert. 


Einschränkung: 


Derzeit sind logische Verbindungen zwischen Datenstationen nicht möglich. 


i 


Bediener 


Anmerkung: 
Es ist unerheblich, 
ob die Anwendungen 


5 A und B im selben oder 


i > in verschiedenen Verarbei- 
Bediener i tungsrechnern bestehen 


Bediener 


Bild 2-4 Beispiel für logische Verbindungen 
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2.2 


2.2.1 


2.2.1.1 


Charakteristische Merkmale von DCAM 


Verteilung ankommender Nachrichten 


Fur die Verteilung von Nachrichten, die fur eine DCAM-Anwendung eintreffen, kann zwischen 
zwei Verfahren ausgewählt werden: 


e Empfang über absenderspezifische oder empfängerglobale Warteschlangen 
e Empfang über verteilcodespezifische Warteschlangen 


Das erste Verfahren ist sowohl für einfach als auch für mehrfach benutzbare DCAM-Anwen- 
dungen geeignet, das zweite nur für mehrfach benutzbare DCAM-Anwendungen. 


Absenderspezifische und empfängerglobale Warteschlange 


Für jede aufgebaute Verbindung wird eine Warteschlange für angekommene Nachrichten 
angelegt, so daß absenderspezifisch auf die Nachrichten zugegriffen werden kann. Der Zugriff 
in der Reihenfolge des Eintreffens (unabhängig vom Absender der Nachricht) wird durch eine 
weitere, empfängerglobale Warteschlange realisiert. Eine Nachricht ist jeweils in eine der 
beiden Warteschlangen eingetragen. Den Zugriff auf die eine oder andere Warteschlange legt 
der Benutzer vorher im Programm fest. Dies ist möglich beim Aufbau einer Verbindung und 
kann mit jedem Senden und Empfangen einer Nachricht für die folgende Verarbeitung neu 
festgelegt werden. 


Auf diese Weise können über einen bestimmbaren Zeitraum nur Nachrichten über die 
absenderspezifische Warteschlange abgeholt werden. Bei mehrfach benutzbaren Anwendun- 
gen wird damit die Verknüpfung eines Prozesses mit einer logischen Verbindung herge- 
stellt. Bei Umschaltung auf die empfängerglobale Warteschlange wird diese Verknüpfung 
wieder aufgelöst. 


Einen Überblick gibt Bild 2-5 


Prozeß 1 hat festgelegt (beim Aufbau der Verbindung oder letztem Senden oder Empfangen), 
daß er Nachrichten von Verbindung A empfangen möchte. Er greift nun mit Empfangsaufru- 
fen auf diese Warteschlange zu. Das gleiche gilt für Prozeß 3 und Verbindung C. Die 
Nachrichten der Verbindung B und D werden von Prozeß 2 empfangen, können aber auch von 
den anderen Prozessen empfangen werden. 
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2.2.1.2 


*) absenderspezifische Warteschlangen 
**) empfängerglobale Warteschlange 


Bild 2-5 Beispiel für Zugriff auf Warteschlangen 


Verteilscodespezifische Warteschlange 


Es wird angenommen, daß die Prozeßgruppe von Programmen mit verschiedenen Fähigkeiten 
gesteuert wird, d.h., jedes der Programme kann nur bestimmte Nachrichten verarbeiten. Die 
Zuordnung Nachricht zu Programm (Prozeß) erfolgt durch einen Code, der sich in der 
Nachricht selbst befindet. Der Benutzer kann den Code wählen und legt beim Aufbau für die 
logische Verbindung bestimmte Codes fest (genaue Beschreibung der Möglichkeiten unter 
3.2.1.4). Für jede Codegruppe wird eine eigene Warteschlange angelegt, die Zuordnung von 
Warteschlangen und Programm wird vom Primärprozeß gesteuert (hierzu stehen eigene 
Aufrufe zur Verfügung, siehe 3.3.4). Bei der Eröffnung der Anwendung wird zu diesem Zweck 
ein Verteilungsname definiert. Er wird den Verteilcodes zugeordnet, um sie mit einem Prozeß 
zu verknüpfen. 


Der Name kann für mehrere Prozesse gleich sein, wenn z.B. ein Programm mehrere Prozesse 
steuert. DCAM gibt dann die Nachrichten nach dem 'fifo’-Prinzip weiter an die verschiedenen 
Prozesse (first in - first out: Der erste Eintrag in die Warteschlange wird auch zuerst 
bearbeitet.). 


Gibt der Kommunikationspartner den Code an, der beim Verbindungsaufbau oder später 
definiert wurde, erreicht er den Prozeß, dessen Verteilungsname vom Primärprozeß diesem 
Code zugeordnet wurde. 
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Der Primärprozeß steuert demnach 


e die Zuordnung der Verteilcodes zu einer Verbindung. 
Wenn er eine Verbindung aufbaut, legt er die verwendbaren Codes fest und kann jederzeit 
neue Codes mit einem eigenen Aufruf für die bestehende Verbindung definieren. 


e die Zuordnung der Verteilcodes zu einem Prozeß über den Verteilungsnamen. 


Nachrichten, die nicht zugestellt werden können, weil ihr Code nicht zugeordnet oder ungültig 
ist, werden dem Primärprozeß zugestellt. 


Bild 2-6 zeigt an einem Beispiel Warteschlangen von Verteilcodegruppen, die nur einen Code 
enthalten. 


Da Nachrichten mit gleichem Code von unterschiedlichen Partnern eintreffen, kann auch 
absenderspezifisch auf diese Nachrichten zugegriffen werden. 

Der Verteilungsname ‘VERTEIL1’ ist sowohl dem Prozeß1 (Primärprozeß), als auch dem 
Prozeß2 zugeordnet. Hier tritt das erwähnte ‘fifo’-Prinzip ein: Nachrichten mit den Codes ‘CA’ 
und ‘CF’ werden in der Reihenfolge ihres Eintreffens jeweils dem Prozeß übergeben, der als 
nächster einen Empfangsaufruf abgibt. Die Nachrichten mit den Codes ‘CD’, 'CX’ und ‘C$’ 
werden Prozeß1 übergeben, da sie keinem anderen Prozeß zugeordnet sind. 


Verteilungs-\VERTEIL 1 VERTEIL 1 VERTEIL2 VERTEIL 4 


namen 


VERTEIL 3 


*) Verteilcode-spezifische Warteschlangen ‘ ™)Standard-Zuordnung 


Bild 2-6 Beispiel für Zugriff auf Verteilcodespezifische Warteschlangen 
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2.2.1.3 


2.2.2 


2.2.3 


2.2.3.1 


Impliziter Verteilcode 


Soll eine Folge von Nachrichten den gleichen Verteilcode enthalten, genügt es, ihn nur in der 
ersten Nachricht anzugeben. Der Primärprozeß legt zu diesem Zweck ein Codeanzeiger- 
Zeichen fest, das anzeigt, daß in einer Nachricht oder einer Folge von Nachrichten ein 
Verteilcode enthalten ist. Der Verteilcode folgt unmittelbar auf dieses Zeichen. Er darf in 
diesem Fall nur höchstens 7 Zeichen lang sein. 


Treffen Nachrichten ohne Verteilcode ein, werden sie entsprechend dem zuletzt gesendeten 
Verteilcode zugestellt. DCAM nimmt den zuletzt vorhandenen Verteilcode für die folgenden 
Nachrichten implizit an. Dies gilt solange, bis dieser Partner eine Nachricht schickt, in der er 
explizit einen Verteilcode angibt. 


Wenn der Primärprozeß kein Codeanzeiger-Zeichen vereinbart hat, muß in jeder Nachricht ein 
Verteilcode stehen. Andernfalls werden sie dem Primärprozeß zugestellt. 


Das Gleiche gilt auch, wenn vergessen wird, eine Folge von Nachrichten mit wenigstens einer 
Nachricht mit Verteilcode zu beginnen. 


Aufrufe und Meldungen 


Die von DCAM gebotenen Funktionen bestehen aus Aufrufen, mit denen der BS2000-Anwen- 
der die Ausführung bestimmter Aktionen veranlassen kann und asynchronen Meldungen 
(siehe 4.1.5), mit denen DCAM den Anwender über bestimmte Ereignisse im Kommunikati- 
onssystem informiert. 


Die Aufrufe an DCAM beginnen alle mit dem Buchstaben Ypsilon. Sie werden entweder als 
Makroaufrufe (Assembler) oder als ‘CALL’-Aufrufe (COBOL) abgesetzt. Die Aufrufe werden 
nach ihrer Ausführung beendet oder aber, wenn eine festgesetzte Bearbeitungszeit abgelau- 
fen ist (synchroner Ausführung). Außerdem besteht die Möglichkeit, die Steuerung unmittel- 
bar, nachdem Aufruf zurückerhalten (asynchrone Ausführung des Befehls an DCAM). Den 
Abschluß des Befehls gibt eine asynchrone Meldung bekannt, die gezielt im Programm 
abgefragt werden kann. Ferner kann mit dem Eintreffen der Meldung eine eigens dafür 
definierte Routine angestoßen werden (Contingency) (siehe 4.1.3). Die asynchrone Verarbei- 
tung dient insbesondere dazu, Wartezeiten zu nutzen. 


Sicherheitskonzept 


Zugriffsschutz 


Innerhalb des Verarbeitungsrechners kann eine DCAM-Anwendung gegen unberechtigten 
Anschluß eines Prozesses geschützt werden. Soll die Anwendung einfach benutzbar sein, so 
ist kein Anschluß eines Sekundärprozesses möglich. Ist die Anwendung mehrfach benutzbar, 
kann mit einem Kennwort der unberechtigte Anschluß eines Sekundärprozesses verhindert 
werden. 


Vordefinierte Anwendung können schon bei der Systemgenerierung in der Netzdatei durch 
ein (Benutzungs-)Kennwort gegen unberechtigtes Eröffnen geschützt werden. Dieses RDF- 
Kennwort muß vom Primärprozeß und Sekundärprozeß mitgegeben werden. 


Innerhalb des Datenkommunikationssystems kann der unberechtigte Aufbau einer logischen 
Verbindung verhindert werden. Einmal, indem DCAM-Anwendungen dauernd oder eine 
bestimmte Zeit keine Aufforderungen zum Aufbau einer Verbindung bearbeiten oder anneh- 
men. Zum zweiten, indem bei der Aufforderung zum Aufbau einer Verbindung ein Kennwort 
angegeben werden muß. Außerdem kann der Benutzer aufgrund einer Verbindungsnachricht 
und/oder der Adresse des auffordernden Partners entscheiden, ob er die Aufforderung 
annimmt oder zurückweist. 

Bei den genannten Verfahren ist gewährleistet, daß irrtümlicher oder auch provozierter 
Fremdanschluß kontrolliert werden kann. Kennworte können zu diesem Zweck auch dyna- 
misch verändert werden (siehe 3.4). 
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2.2.3.2 


2.2.3.3 


Datensicherheit 


Die Datensicherheit ist ein weiterer Punkt des Sicherheitskonzepts. Auf der Ebene der 
physikalischen Datenübertragung werden gesicherte Prozeduren verwendet (HDLC, MSV1, 
MVS2, LSV1, NEA), die durch geeignete Fehlerüberwachung und automatische Fehlerkorrek- 
tur die Sicherheit der übertragenen Daten garantieren (siehe auch Bild 2-7). 


DCAM/BCAM 


BEE 


speicher 


Übermittlung von Daten (Nachricht mit Laufnummer) 


+ De ') Gutquittung der Datenübertragungsprozedur (ACK) 
pos nlp 2) Gutquittung der Nachrichten-Ein-/Ausgabe 


E E Transportquittung 


T) hier wird die Transportquittung erzeugt, wenn die Nachricht 
beim Empfänger (Datenstation) angekommen ist (positiv 
quittiert wurde) 


Bild 2-7 Beispiel für die Quittierung von Nachrichten 


Durch die Zuordnung und Aufteilung der Speicherkapazitäten auf logische Verbindungen, 
wird eine gegenseitige Beeinflussung (z. B. durch Monopolisierung des Speichers) ausge- 
schlossen und ein weiterer Sicherheitsfaktor eingeführt. Darüber hinaus hat der Benutzer die 
Möglichkeit, Transportquittungen für gesendete Nachrichten zu empfangen. Er kann entwe- 
der gar keine, nur negative oder negative und positive Quittungen empfangen. Eine negative 
Quittung wird erzeugt, wenn eine Nachricht, aus welchem Grund auch immer, nicht zugestellt 
werden kann. Eine positive Quittung wird erzeugt, wenn die Nachricht beim Empfänger (in 
seinem Datenspeicher) angekommen ist. Der Absender, der eine Laufnummer der Nachricht 
mitgegeben hat, erhält unter dieser Nummer die Quittung, die am Zielort erzeugt und durch 
das Netz transportiert wurde. 


Er kann die Transportquittung wie jede andere Nachricht empfangen. Er kann aber auch die 
Transportquittung als asynchrone Meldung (siehe auch 4.1.5) erhalten. In einer Proze&gruppe 
besteht ferner die Möglichkeit, die Transportquittung generell im Primärprozeß oder dem die 
Quittung anfordernden Prozeß zu übergeben (siehe auch 3.3.2). 


Einschränkung: 


COBOL-Anwender können Transportquittungen nicht als asynchrone Meldung empfangen. 


Expreßnachrichten 


Ein anderer Aspekt der Datensicherheit, die Lösung von Konfliktfällen, ist auch berücksichtigt. 
Im Datenkommunikationssystem TRANSDATA sorgt eine verbindungsbezogene Kapazitäts- 
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2.2.3.4 


verteilung für die reibungslose Datenübermittlung. Die vorhandenen Zwischenspeicherberei- 
che werden genutzt, indem jede Verbindung nur einen bestimmten Teil belegen darf. Die 
Zwischenspeicher können so nicht vollständig durch die Daten einer Verbindung belegt 
werden. Damit aber bei Rückstaus, die eine Verbindung betreffen, diese noch bedienbar 
bleibt, können kurze Expreßnachrichten fester Länge mit hoher Priorität dem Empfänger 
zugestellt werden. Solche Nachrichten 'überholen’ sozusagen die anderen. Wenn der Emp- 
fänger dies will, bekommt er die Expreßnachricht als asynchrone Meldung sofort übergeben 
(siehe 4.1.5), ansonsten wird sie möglichst weit vorn in die Warteschlange eingetragen. 
Expreßnachrichten können nicht übermittelt werden, wenn die entsprechende Verbindung 
mit einer logischen Datenstation zusammenarbeitet. 


Einschränkung: 


COBOL-Anwender können Express-Nachrichten nicht als asynchrone Meldung empfangen. 


Datenfluß-Steuerung 


Das System kann eine überlastete Verbindung entlasten, indem es die Nachrichtenübermitt- 
lung vorübergehend unterbricht. Davon können sowohl normale als auch Expreßnachrichten 
betroffen sein. 

Sobald die Verbindung wieder bedienbar ist, kann dem Benutzer durch ein GO-Signal 
angezeigt werden, daß der Stau für normale bzw. für Expreßnachrichten behoben ist und daß 
erneut mit dem Senden von Nachrichten begonnen werden kann. 
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2.3 


2.3.1 


Planung des Programmaufbaus 


Wenn ein DCAM-Programm geplant wird, kann die Aufgabe bereits festliegen. Es kann aber 
auch sein, daß aufgrund der Möglichkeiten, die gegeben sind, die Problemstellung überdacht 
oder überhaupt erst formuliert wird. Zu Beginn sollten daher zunächst einige mögliche 
Aufgabenstellungen skizziert werden. 


Aufgaben eines DCAM-Programms 


DCAM-Programme werden geschaffen, um Teilhaberbetrieb im BS2000 zu realisieren. Im 
Gegensatz zum Teilnehmerbetrieb ist seine Aufgabenstellung und Realisierung abgeschlos- 
sen, wenn der Teilhaberprozeß gestartet wird. 

Ferner werden hier meist Aufgaben gelöst, die nur mit spezifischen Mitteln des BS2000 lösbar 


sind (siehe Tabelle 2-1). 


Aufgaben im Teilhaberbetrieb 


Dialog zwischen einzelnen 
wenigen Datenstationen und 
einem Programm. 


Dialoge in einzelnen 
Schritten oder in einer 
Folge von Anfragen und 
Antworten. 


Bearbeitung von Anfragen 
einer großen Zahl von 
Datenstationen in einem 
Programmsystem 


Datenübernahme von Pro- 
grammen in eigenen oder in 
anderen Verarbeitungs- 
rechnern des Datenkommuni- 
kationssystems TRANSDATA 


Weitergabe von Daten an 
reine Datenverarbeitungs- 
programme im eigenen Ver- 
arbeitungsrechner und 
Koordinierung der 
Zusammenarbeit 


Aufbau von Nachrichten für 
zeilenweise Ausgabe oder 
Formatdarstellung auf 
Bildschirm 


Ausnutzung spezifischer 
Datenstationseigenschaften 


Unterstützt im BS2000 durch: 


- Synchrone Bearbeitung von DCAM-Aufrufen. 
- Verwaltung von Primärprozessen 
(einfach verwendbare DCAM-Anwendungen) . 


- Warteschlangen für Zugriff auf bestimmte 
oder beliebige Partner. 

- Begleitinformation der Verbindung zur 
Übergabe mit der Nachricht (z.B. mit der 
Adresse eines Speicherbereichs) . 
Einschränkung: Bei COBOL nicht anwendbar. 


- Asynchrone Bearbeitung von DCAM-Aufrufen 

mit P1 EVENTING und 
CONTINGENCIES. 

- Verwaltung von Primär- und Sekundärpro- 
zessen (mehrfach benutzbare DCAM- 
Anwendung) . 

- Unterstützung der ’reentrant’-Programmie- 
rung. 


- Synchrone oder asynchrone Bearbeitung von 
DCAM-Aufrufen. 
- Ereignisgesteuerte Verarbeitung mit 
P1 EVENTING und 
CONTINGENCIES 


- Benutzung lokaler oder gemeinsamer Spei- 
cherbereiche mit COMMON MEMORY und Seriali- 
sierung. 

- Koordinierung durch P1 EVENTING, Inter- 
Prozeß-Kommunikation oder Benutzer- 
Schalter (USER SWITCHES). 


- Unterstützung durch Umsetzung von Logi- 
schen Datenstationen in physikalischen 
Eigenschaften einzelner Datenstationstypen 
(VTSU). 


- Möglichkeit der ‘physikalischen’ Program- 
mierung von Datenstationen. 
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Aufgaben im Teilhaberbetrieb | Unterstützt im BS2000 durch: 


Bearbeitung von Anfragen - Steuerung der Prozesse im TIMESHARING. 

in einer möglichst kurzen - Schnelle Dateizugriffe mit USER PAM. 

Zeit, um dem Datenstations- - Re-entrant-Steuerung von Programm mit 

benutzer günstige Antwort- SHARED CODE verbunden mit günstiger 

zeiten zu bieten. Speicherauslastung und geringer 
Seitenwechselrate. 

Bearbeitung unterschied- - Nachrichtenverteilung über Verteilcode- 

licher Anforderungen einer spezifische Warteschlangen. 

Datenstation in einem 

Programmsystem. 

Gewährleistung der - Übermittlung von Transportquittungen für 

Datensicherheit Nachrichten. 


- Übermittlung von Expreßnachrichten. 
- Verhinderung des Mehrfachzugriffs bei 
Dateien auf einzelne Sätze: 
ISAM SHARED UPDATE 
oder Blöcke (Halbseiten): 
USER PAM SHARED UPDATE 


Sicherung gegen unbefugte - Kennwort-Schutz der DCAM-Anwendung 
Zugriffe auf Programme oder - Kennwort-Schutz der logischen Verbindung 
Programmsysteme, bzw. auf - Kennworte zum Schutz 

Dateien von Dateien gegen unberechtigtes Lesen, 


Schreiben und Ausführen 


Tabelle 2-1 Teilhaberbetrieb mit BS2000 
Dem Programmierer stehen zur Verfügung: 


Die Dienstleistungen der Schnittstellen von TRANSDATA DCM (Data Communication 
Methods), des Organisationsprogramms und Datenverwaltungssystems (DVS). 


Es ist zweckmäßig, DCAM-Programme zu unterteilen. Bei der SHARED CODE-Programmie- 
rung ist eine Gliederung in Befehlsteil, Konstantenteil und dynamischen Arbeitsbereich 
gefordert. Dies ist auch zu empfehlen für die Dokumentation und spätere Wartung. 


Bei einfachen Aufgaben können Programme in einen Teil für die Datenkommunikation und 
einen für die Verarbeitung aufgeteilt werden. Einfache Aufgaben wären: Bedienung weniger 
Datenstationen, Einschritt-Dialog, keine besonderen Sicherheitsanforderungen, usw. 


Komplexere Aufgaben erfordern eine weitgehende Verzahnung der verschiedenen Schnitt- 
stellen und lassen darum eine Grenzziehung nur zu, wenn sie entsprechend der spezifischen 
Problemstellung vorgenommen wird. Dafür können hier keine allgemeinen Regeln aufgestellt 
werden. Durch die Ermöglichung von Programmsystemen, die einen Primärprozeß und einige 
Sekundärprozesse steuern, wird vom System die Strukturierung komplexer Aufgaben unter- 
stützt. Damit verbunden ist auch die Möglichkeit gegeben, die Codierung in Assembler- und 
COBOL-Module aufzuteilen. 


Bevor näher auf die spezifischen Aufgaben eines Primärprozesses und der Sekundärprozesse 
eingegangen wird, soll gezeigt werden, welche Elemente unbedingt nötig sind, um ein 
DCAM-Programm zu erstellen. 
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2.3.2 


Grundstruktur eines DCAM-Programms 


In einem DCAM-Programm oder Programmsystem müssen zwei vorbereitende Schritte getan 
werden, bevor die eigentliche Datenubermittlung beginnen kann: 


1. Schritt: 


2. Schritt: 


Eröffnen einer DCAM-Anwendung. 


Damit ein Programm fir andere Kommunikationspartner adressierbar wird, 
muß es mindestens eine DCAM-Anwendung eröffnen. Der Name, der dabei 
festgelegt wird, bildet zusammen mit den Namen des Prozessors (Prozes- 
sorknotens) die symbolische Netzadresse in einer Netzregion. Es werden 
ferner Eigenschaften der DCAM-Anwendung bestimmt und es werden 
Vorgaben für Kennworte gemacht. Die Anweisung, die diesen Schritt 
ausführt, lautet YOPEN. 


Aufbau einer logischen Verbindung 


Damit Datenübermittlung zwischen zwei Kommunikationspartnern erfolgen 
kann, muß vorher ein Partner die Aufforderung zum Aufbau einer logischen 
Verbindung an den anderen richten und dieser muß sie annehmen. Mit 
anderen Worten: es wird eine logische Verbindung aufgebaut. Zwischen- 
speicherung und Verteilung der Nachrichten erfolgt aufgrund der Angaben, 
die hierbei festgelegt werden. Ferner ist anzugeben, welche Nachrichten- 
aufbereitung gewünscht wird, bzw. ob der Benutzer sie selbst übernimmt. 
Des weiteren können die Kommunikationspartner gegenseitig Begleitinfor- 
mationen austauschen. Die Anweisung für diesen Schritt lautet YOPNCON 
ACCEPT (Annahme Verbindungswunsch) oder YOPNCON ACQUIRE (Aus- 
gabe Verbindungswunsch). 


Nach den beiden vorbereitenden Schritten kann das Empfangen von Nachrichten mit 
YRECEIVE und das Senden mit YSEND erfolgen. 


Nach Beendigung der Datenübermittlung wird eine logische Verbindung entweder explizit 
vom Programm abgebaut mit YCLSCON oder aber implizit mit der Schließung der DCAM- 
Anwendung durch die Anweisung YCLOSE, bzw. durch die Beendigung des Programms. Eine 
logische Verbindung kann aber auch indirekt an der Datenstation durch die Eingabe eines 
vereinbarten Endekriteriums getrennt werden. Dieses muß dann im Programm zur Ausfüh- 
rung des YCLSCON führen. Der Abbruch einer logischen Verbindung durch das Abschalten 
der Datenstation, Ausfall einer Leitung, usw. kann dem Programm gemeldet werden. 
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*) nur bei Assembler, für COBOL sind die 
entsprechenden Kommandos im Kommandomodus 
zu verwenden 


Bild 2-8 Prinzipieller Ablauf eines DCAM-Programms. 


Einfluß auf die Struktur des Programms kann ferner die dynamische Namen-Zuweisung 
haben. Die Eintragungen der dynamisch zugewiesenen Namen, Kennworte und des Benutzer- 
feldes müssen vor Eröffnen der DCAM-Anwendung bzw. vor Aufbau der Verbindung in die 
CLT (Communication Link Table) erfolgen. In einem eigenen Programm oder in einer Vorlauf- 
routine sollten die Aufrufe YAPPL bzw. YCONN stehen, oder es muß dafür gesorgt werden, 
daß entsprechend die Kommandos /APPLICATION und /CONNECTION gegeben werden 
(siehe auch Bild 2-8). 


Einschränkung: 
In COBOL-Programmen sind keine YAPPL- bzw. YCONN-Aufrufe möglich. 


Nach jedem Aufruf an DCAM ist zu prüfen, ob er richtig ausgeführt wurde. Zu diesem Zweck 
wird eine Rückmeldung (FDBK) zur Verfügung gestellt. Das Ergebnis der Prüfung kann sein, 
daß ein Aufruf wiederholt wird, in anderer Weise auszuführen ist, ggf. andere Maßnahmen zu 
treffen sind, oder aber auch der Programmlauf beendet werden muß. Die Fehlerroutine kann 
unmittelbar im Anschluß an den Aufruf codiert werden, wird aber, da meist dieselben oder 
ähnliche Maßnahmen zu treffen sind, einmal vorhanden sein und immer wieder angesprungen 
werden. In diesem Fall würde eine zentrale Fehlerbehandlungsroutine zu schaffen sein. 
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Steuerung von Primär- und Sekundärprozessen 


Ein Primärprozeß, der als erster eine DCAM-Anwendung eröffnet, kann alle prinzipiellen 
DCAM-Funktionen (siehe voriger Abschnitt) enthalten. In einer Prozeßgruppe ist er automa- 
tisch der steuernde Prozeß und enthält die Verbindungsfunktion, Verteilcodesteuerung, 
Festlegungen von Kennworten, also alles, was die Prozeßgruppe als ganzes betrifft. 


Daß er auch zeitlich der ersteröffnende ist, kann bei YOPEN mit VERIFY überprüft werden. Er 
kann, wie auch die Sekundärprozesse, Nachrichten senden und empfangen. Beim Schließen 
der DCAM-Anwendung im Primärprozeß wird sie auch für die Sekundärprozesse geschlossen. 


Der Aufbau des Programms, das den Primärprozeß steuert, ist abhängig von der Beantwor- 
tung verschiedener Fragen, die in Tabelle 2-2 mit ihren Antworten zusammengestellt sind. 


Fragen zum Aufbau eines Maßnahmen bei bejahender Antwort der Fragen 
Programms, welches einen 


Primärprozeß steuert 


Ist die zu bedienende 
Konfiguration klein? 
Ist die mittlere Zeit, 
die verstreicht zwi- 
schen der Ankunft 
zweier Nachrichten 
groß (geringe Aus- 
lastung) ? 

Ist die Aufgabe in 
ihrem Umfang so be- 
grenzt, daß keine Auf- 
teilung in unterschied- 
liche Bearbeitungspro- 
gramme notwendig ist? 


Ist die mittlere Zwi- 
schenankunftszeit zwi- 
schen zwei Nachrichten 
klein? 

Ist die Konfiguration 
groß? | 
Wird eine kurze Bear- 
beitungszeit gefordert? 


Müssen die Anfragen, 
die über logische Ver- 
bindungen eintreffen, 
unterschiedlicher Be- 
arbeitung übergeben 
werden? 

Wechseln die Verteil- 
codes in den Nachrich- 
ten? 

Sollen aus Sicherheits- 
gründen Kennworte den 
Anschluß eines Pro- 
zesses an eine DCAM- 
Anwendung schützen? 
Sollen alle Daten über- 
prüft werden? 

Sollen weitere Steuer- 
funktionen realisiert 
werden? 


Der Primärprozeß führt die Bearbeitung alleine 
durch, es sind also keine Sekundärprozesse not- 
wendig und erlaubt (einfach verwendbare DCAM- 
Anwendung) . 


Der Primärprozeß und die Sekundärprozesse 

werden von einem SHARED CODE Programm gesteuert. 
Da der Primärprozeß spezifische Funktionen 
ausführen muß, ist dies im Programmablauf vor- 
zusehen. Oder aber das Programm wird modular auf- 
gebaut und es werden in den Prozessen nur die 
spezifischen Module benutzt und geladen. 


Der Primärprozeß steuert die Verteilcode- 
Zuordnung zu den Sekundärprozessen und damit 
die Nachrichtenverteilung. Er legt ein Kennwort 
zum Anschluß von Sekundärprozessen fest. Er 
überprüft die Nachrichten, die innerhalb der 
Gruppe nicht zustellbar sind. Im Rahmen von 
Common Memory, P1 Eventing usw. stehen dem 
Primärprozeß weitere Mittel zur Steuerung der 
Prozeßgruppe zur Verfügung. 


— mm E E E 


Tabelle 2-2 Steuerung eines Primärprozesses 
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2.3.4.1 


Ein Sekundärprozeß, der als zweiter oder weiterer Prozeß eine DCAM-Anwendung eröffnet, 
hat auf die Eigenschaften der DCAM-Anwendung keinen Einfluß, ggf. muß er ein Kennwort 
angeben, um sich an die Gruppe anzuschließen. Mit VERIFY kann er überprüfen, ob er zeitlich 
nach dem Primärprozeß die Anwendung eröffnet. Die logischen Verbindungen kann er weder 
aufbauen noch abbauen. Innerhalb der Gruppe hat er keine Steuerfunktion. Seine Aufgabe ist 
das Senden und Empfangen von Nachrichten und deren Verarbeitung. Beim Aufbau des 
Programms ist daher nur von Bedeutung, in welcher Form YSEND-, YRECEIVE- oder YSEN- 
DREC-Aufrufe abgesetzt und bearbeitet werden. Zu beachten ist, daß ggf. Steuereingriffe des 
Primärprozesses berücksichtigt werden müssen (Verbindungssteuerung, Verteilcodezuord- 
nung eingehender Nachrichten, usw.). Wird im Sekundärprozeß die DCAM-Anwendung 
geschlossen, hat dies keinerlei Einfluß auf die anderen Prozesse der Gruppe. 


Zugriff zu Datenstationen 


Für die Planung von DCAM-Programmen ist von Bedeutung, wie die Zugriffe auf Datenstatio- 
nen ausgeführt werden sollen. 


Dem DCAM-Programmierer stehen zwei Methoden zur Auswahl: 
e physikalische’ Programmierung oder 
e Benutzung der Logischen Datenstationen. 


Die ‘physikalische’ Programmierung erfordert die Bedienung einer Datenstation mit den 
Steuerzeichen, die sie versteht (siehe die Benutzerhandbücher der einzelnen Datenstationen). 
Damit kann er zwar sehr viele Möglichkeiten nutzen, hat aber die Mühe der Bedienung mit 
Steuerzeichen. Die Logischen Datenstationen nehmen ihm diese Arbeit ab. Alle wesentlichen 
Funktionen sind über diese standardisierten Datenstationen erreichbar (nicht bei lokal ange- 
schlossenen Datenstationen). 


Die Logischen Datenstationen sind im Datenkommunikationssystem TRANSDATA Software- 
Bausteine des Benutzer-Services. Bereits beim Aufbau einer Verbindung stimmen sich die 
Kommunikationspartner darüber ab, welche Logische Datenstation benutzbar ist, bzw. 
benutzt werden soll. Dazu ist beispielsweise zu klären, ob ein Hardcopy-Gerät an einer 
Datenstation angeschlossen ist oder ob ein Lichtgriffel benutzt werden soll. 


Der Programmierer hat zwei Logische Datenstationen zur Auswahl: Die Zeilen-Datenstation 
und die Format-Datenstation. 


Zeilen-Datenstation 


Die Zeilen-Datenstation wird durch den Baustein VTSU (virtual terminal support) im System 
realisiert. Der Benutzer hat die Daten nur in logische Zeilen zu gliedern und benutzt dazu ein 
geräteunabhängiges Steuerzeichen ‘Neue Zeile’. Das Umsetzen in die tatsächlichen Zeilen der 
Datenstation wird im System vorgenommen. Dabei werden logische Zeilen ggf. in weitere 
Zeilen unterteilt, sollte die verfügbare Zeilenlänge des Gerätes (Schreibstation, Datensichtsta- 
tion, Druckerstation) nicht ausreichen. 


Erhält das Programm Nachrichten von der Zeilen-Datenstation, so wird ihm das Zeilenende 
durch das gleiche geräteunabhängige Zeichen ‘Neue Zeilen’ angezeigt. Der Beginn einer 
Nachricht ist bei Ein-/Ausgabe automatisch der Beginn einer neuen Zeile, das Ende der 
Nachricht das Ende einer Zeile. 

Die Zeilen-Datenstation verarbeitet nur abdruckbare Zeichen. 


Bild 2-9 zeigt den Weg von Nachrichten durch das System bei Verwendung der Zeilen-Daten- 
station. 
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Benutzer: | System: 


Bild 2-9 Senden und Empfangen von zeilenweise abzubildenden Daten 


Zusätzlich kann der Benutzer verfügen über die logischen Steuerzeichen: 


Neue Seite 

Neue Zeile 
Hervorheben Ein 
Hervorheben Aus 
Shift Ein 

Shift Aus 


sowie über 

e Ausgabe des Funktionstastencodes 
e Strukturieren der Ausgaben. 
Zusätzliche Satzsteuerzeichen: 

e logisches Zeilenende 
Logische Anzeigensteuerzeichen: 
hervorgehobene Anzeige 2 
hervorgehobene Anzeige 3 
hervorgehobene Anzeige 4 
dunkle Anzeige 

Beginn Proportional-Schrift 


Ende Proportional-Schrift 


Beginn geschützter Bereich 


Ende geschützter Bereich 
Weitere logische Steuerzeichen: 
e Löschzeichen 

e Ruckwéartsschritt 

e aktuelle Positionierung 

® 


vertikale Position (Zeile) 


Beginn ungeschützter numerischer Bereich 
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e horizontale Position (Spalte) 
e Steuerung Blatteinzug bzw. -auswurf 
e linker Rand 


e Zeilenabstand 


e Zeichenabstand 

e maximale Zeilenlänge 

e maximale Zeilenanzahl 

e Ersatzzeichen 

e Zeile tiefgestellt 

e Zeile hochgestellt 

Physikalische Steuerzeichen: 

e ESCAPE 

e Transparentes Übertragen des ersten Zeichens 
e Horizontaler Tabulator 


e Vertikaler Tabulator 


Das Steuerzeichen ‘Neue Seite’ im Ausgabetext einer Nachricht veranlaßt folgende Aktionen: 
e Ausgeben eines logischen Zeilenendes 


e Seitenvorschub, d.h. 


bei Datensichtstationen: Löschen des Bildschirms 
Positionieren auf Schirmanfang (nicht bei 8161 im Rollup- 
Betrieb) 

bei Druckerstationen: Seitenvorschub 

bei Schreibstationen: Vorschub um 10 Zeilen 


Das Steuerzeichen ‘Hervorheben Ein’ bewirkt, daß der folgende Nachrichtentext kursiv oder 
blinkend ausgegeben wird, bis die Steuerzeichen ‘Hervorheben Aus’ oder ‘Neue Zeile’ oder 
‘Neue Seite’ gefunden werden, oder bis zum Ende der Nachricht. 


Das Steuerzeichen ‘Shift Aus’ schaltet auf den zweiten Zeichenvorrat um, falls ein solcher 
verfugbar ist. Mit dem Steuerzeichen ‘Shift Ein’ kann man wieder auf den Standardzeichen- 
vorrat umschalten. 


Die Funktion ‘Ausgabe des Funktionstastencodes’ ermöglicht es dem Benutzer, sich den 
geräteunabhängigen Code von Funktionstasten oder Kurznachrichten als erstes Byte einer 
Nachricht ausgeben zu lassen. 


Mit der Funktion ‘Strukturierung der Nachricht’ kann der Benutzer entscheiden, ob die 
gesamte Nachricht als Struktureinheit behandelt werden soll oder ob jede logische Zeile der 
Nachricht eine Struktureinheit sein soll. Es folgt eine kurze Erläuterung der beiden Strukturty- 
pen am Beispiel der Datensichtstationen 816x. 


Struktureinheit ‘Nachricht’ bedeutet: 


Die Nachrichtenlange ist beschrankt durch den Systemausgabepuffer. Durch Modifikation 
eines Zeichens kann die gesamte Nachricht wieder zurückübertragen werden. 


Struktureinheit ‘Logische Zeile’ bedeutet: 


Die Nachrichtenlänge ist nicht beschränkt, falls die logischen Zeilen nicht länger als 255 
Zeichen sind. Logische Zeilen können einzeln modifiziert und damit gezielt zurückübertragen 
werden. 
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2.3.4.2 


Die Funktion ‘Hardcopy’ ermöglicht es, die Bildschirmausgabe gleichzeitig auf einem Hardco- 
py-Gerat zu protokollieren. 


Durch das Steuerzeichen ‘logisches Zeilenende’ werden besondere Anzeigeformen an der 
Datenstation auf den Normalzustand zurückgesetzt (normal, 1. Zeichenvorrat, ungeschützt). 
Das definierte Zeilenendezeichen wird ausgegeben. 


Durch das Steuerzeichen ‘Beginn geschützter Bereich’ werden die nachfolgenden Textzei- 
chen am Bildschirm ‘geschitzt’ ausgegeben, d.h., sie können nicht überschrieben und zur 
DVA zurückübertragen werden. 


Mit dem Steuerzeichen ‘Ende geschützter Bereich’ werden die nachfolgenden Textzeichen 
ungeschützt an die Datenstation ausgegeben. 


Durch das Löschzeichen wird ein Zeichen aus dem Ausgabetext entfernt und nicht an die 
Datenstation weitergeleitet. 


Mit dem ‘Ruckwértsschritt’ wird das nachfolgende Textzeichen über dem vorangegangenen 
abgebildet. Damit kann ein nicht im Zeichenvorrat vorhandenes Zeichen abgebildet werden. 


Format-Datenstation 


Die Format-Datenstation erfordert die Verwendung der Module und Makros der Formatsteue- 
rung. 


Die Makroaufrufe der FORM-Schnittstelle dienen der Formatbeschreibung. Bei COBOL- 
Programmen muß sie gesondert erstellt werden. Die Formate werden später als eigene 
Module in das COBOL-Programm eingebunden. Zur Bearbeitung der Formatfelder stehen in 
Assembler und COBOL Adressierungshilfen zur Verfügung. Das Programm arbeitet beim 
Senden und Empfangen von Nachrichten mit einer Formatierungsroutine zusammen. In ihr 
werden die Formate zur Abbildung auf der physikalischen Datenstation (Schreibstation, 
Datensichtstation) aufbereitet. Nachrichten von der Datenstation werden hier wieder umge- 
setzt (siehe auch Bild 2-10). 
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Benutzer: . Kommunikations- 
Zugriffssystem: 


[------------- 


*) bei Assemblerprogrammen braucht die 
Generierung nicht separat zu erfolgen. 
**) die Formatierungsroutine wird in das 
Benutzerprogramm eingebunden 


Bild 2-10 Senden und Empfangen von formatierten Daten 


Sowohl fur die Zeilen-Datenstation als auch fur die Format-Datenstation werden auf Wunsch 
ausgeführt: | 


e Behandlung der Groß- und Kleinschreibung 

e Bearbeitung von Rückwärtsschritt-Zeichen (backspace) 
e Ausgabe gleichzeitig auf Hardcopy-Gerät 
i 


Auslösen eines akustischen Alarms 
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2.3.5 


2.3.5.1 


2.3.5.2 


Realisierung des Verarbeitungsverbundes 


Das Kommunikationssystem TRANSDATA ermöglicht die Kommunikation zwischen 
e Datenstationen und Anwendungen 
e Anwendungen und Anwendungen 


Dabei können sich sowohl Datenstationen als auch Anwendungen in einem komplexen Netz 
aus Verarbeitungsrechnern, Datenübertragungsvorrechnern, Netzknotenrechnern und 
Datenstationsrechnern befinden. 


Abgesehen von der Verbindung mit Datenstationen ergeben sich daraus für eine DCAM- 
Anwendung folgende Möglichkeiten: Der Partner ist 


e eine DCAM-Anwendung 
e eine UTM-Anwendung 


e eine PDN-Anwendung 


DCAM-Anwendung als Partner 


Der Kommunikationspartner DCAM-Anwendung wird in Kapitel 3 beschrieben. Die Existenz 
einer DCAM-Anwendung beschreibt 3.1. Über den Aufbau einer logischen Verbindung 
zwischen DCAM-Anwendungen informiert 3.2. Die Datenübermittlung zwischen DCAM- 
Anwendungen erklärt 3.3. 


UTM-Anwendung als Partner 


Die Kommunikation zwischen einer DCAM-Anwendung und einer UTM-Anwendung ist immer 
dann möglich, wenn die DCAM-Anwendung für die UTM-Anwendung als Kommunikations- 
partner generiert ist und eine logische Verbindung zwischen beiden Anwendungen aufgebaut 
ist. Es spielt keine Rolle, ob sich die Anwendungen im gleichen oder in verschiedenen 
Verarbeitungsrechnern befinden. 


Der Verbindungsaufbau zwischen einer DCAM-Anwendung und einer UTM-Anwendung ist 
auf 3 Arten möglich: 


e Die UTM-Anwendung wurde so generiert, daß bei ihrem Start die Verbindung aufgebaut 
werden soll. Sie ist aufgebaut, wenn die DCAM-Anwendung zu diesem Zeitpunkt existiert 
und den Verbindungswunsch explizit akzeptiert. 


e Die UTM-Anwendung wurde so generiert, daß Verbindungswünsche der DCAM-Anwen- 
dung angenommen werden. Die Verbindung ist aufgebaut, wenn beide Anwendungen 
existieren und die DCAM-Anwendung einen expliziten Verbindungswunsch ausgegeben 
hat. 


e Mit einem UTM-Administrationskommando kann veranlaßt werden, daß ein Verbindungs- 
wunsch an eine DCAM-Anwendung ausgegeben wird. 


Bei der Datenübermittlung ist zu beachten, daß die UTM-Anwendung eine Struktur besitzt. 
Die UTM-Anwendung besteht aus Teilprogrammen, die über einen ihnen zugeordneten 
Transaktionscode adressiert werden können. Beim Beginn eines Vorgangs müssen die Daten 
am Anfang diesen Transaktionscode enthalten. 
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2.3.5.3 


PDN-Anwendung als Partner 


Eine PDN-Anwendung wird im Betriebssystem eines Datenstationsrechners mit der Generie- 
rungssprache KOGS generiert. Die PDN-Anwendung wird existent durch die Ankunft einer 
Nachricht fur die PDN-Anwendung. 


@ voneiner angeschlossenen Datenstation 
e voneiner im gleichen Rechner existierenden PDN-Anwendung und durch 


e die Ankunft eines Verbindungswunsches eines anderen Kommunikationspartners aus 
dem TRANSDATA-Netz. | 


PDN-Anwendungen können auch selbst logische Verbindungen aufbauen. 


Beim Verbindungsaufbau und bei der Datenübertragung ist zu beachten, daß DCAM eine 
PDN-Anwendung als Anwendung behandelt. Daraus folgt, daß das System keine Nachrich- 
tenbehandlung durchführt. Insbesondere kann der Benutzer keine logischen Datenstationen 
verwenden. 
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3.1 


Funktionen von DCAM 


Die Funktionen, die DCAM bietet, lassen sich in 4 Gruppen einteilen: 
e Existenzfunktion 

e Verbindungsfunktion 

e Datenübermittlungsfunktion 

e Namen-Zuweisungsfunktion. 


Im folgenden werden diese Funktionen in allen Einzelheiten diskutiert. Die weitere Aufteilung 
dieses Kapitels entspricht der Aufteilung des Kapitels 3 in dem Assembler-Benutzerhandbuch 
(siehe DCAM-Makroaufrufe) und dem COBOL-Benutzerhandbuch (siehe DCAM-COBOL- 
Aufrufe). Dort sind die entsprechenden Aufrufe mit den erforderlichen Parametern darge- 
stellt. 


Existenzfunktion 


Die Existenzfunktion der DCAM-Schnittstelle führt aus: 


e Eröffnen bzw. Erzeugen einer DCAM-Anwendung (YOPEN). 
Dies ist die Grundfunktion von DCAM, die je nach Art der DCAM-Anwendung unterschied- 
lich ausgeführt wird. 


e Verändern des Zustands einer DCAM-Anwendung (YSETLOG). 
Mit dieser Funktion kann der Zustand der DCAM-Anwendung - die Bereitschaft, Aufforde- 
rungen zum Verbindungsaufbau zu bearbeiten dynamisch verändert werden. 


e Abfragen des Zustands einer DCAM-Anwendung (YINQUIRE). 
Da eine dynamische Änderung (siehe voriger Punkt) möglich ist, wird auch diese Abfrage- 
funktion geboten. 


e Schließen einer DCAM-Anwendung (YCLOSE). 
Zwar wird die DCAM-Anwendung bei Programmende automatisch geschlossen, mit 
dieser Funktion kann sie aber auch jederzeit im Programmablauf geschlossen werden. 


Eröffnen einer DCAM-Anwendung 


Eine DCAM-Anwendung wird erzeugt, wenn das erste Programm sie eröffnet. Dabei wird 
festgelegt, ob diese Anwendung einfach oder mehrfach benutzbar sein soll. Eine einfach 
benutzbare Anwendung kann nur in einem Programm eröffnet werden und wird auch durch 
dieses wieder geschlossen. Eine mehrfach benutzbare Anwendung kann auch von weiteren 
Programmen (Sekundärprozessen) eröffnet werden, die allerdings sich nur anschließen und 
auf die Festlegungen des ersteröffnenden/erzeugenden Programms (Primärprozeß) keinen 
Einfluß haben. Weiterhin ist anzugeben, ob die Nachrichtenverteilung über die verteilcode- 
spezifischen Warteschlangen erfolgen soll. Daraus ergeben sich unterschiedliche Varianten 
des Aufrufs YOPEN. 


Angaben für die dynamische Namen-Zuweisung werden in einem Abschnitt (siehe 3.4) 
gesondert erläutert. 
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3111 


Einfach benutzbare DCAM-Anwendung 


Eine DCAM-Anwendung, die einfach benutzbar sein soll (NSHARE), kann nur von einem 
Prozeß eröffnet werden. Jeder weitere Versuch, diese Anwendung zu eröffnen, wird zurück- 
gewiesen. Im Rahmen dieser Einschränkung sind weitere Festlegungen sinnvoll zu treffen, 
abhängig von verschiedenen Faktoren, siehe dazu Tabelle 3-1. 


Voraussetzung(en) 


Der Name der DCAM-Anwendung soll 
nicht vom Kommunikations-Zugriffs- 
system generiert werden. 


Er muß geklärt sein, ob die DCAM- 
Anwendung nur Aufforderungen zum 
Verbindungsaufbau ausgibt. Voraus- 
setzung dafür ist, daß alle möglichen 
Partner entweder Datenstationen sind 
oder DCAM-Anwendungen, die Auffor- 
derungen bearbeiten. 


Im Programm ist nicht bekannt, ob und 
wann ein Partner sich anschließen 
will, bzw. der Partner selbst ist 
nicht bekannt. 


Die Anwendung ist durch ein Kennwort 
in der RDF (APPPW=, siehe Manual 
"Generierung eines Datenkommunika- 
tionssystems’) geschützt. 


Unbefugte Aufforderungen zum Aufbau 


einer Verbindung sollen automatisch 
zurückgewiesen werden. 


Es sollen asynchrone Meldungen 
angenommen werden. 


Es sollen bestimmte neue Funktionen 
einer DCAM-Version (ab 8.0) benutzt 
werden. 


Tabelle 3-1 


Einschränkung: 


Festlegung 


Name der DCAM-Anwendung 


Attribut NLOGON: 
Aufforderungen zum Verbindungsaufbau 
werden nicht bearbeitet. 


Attribut LOGON: 
Aufforderungen zum Verbindungsaufbau 
werden bearbeitet. 


Kennwort USEPW 


Kennwort (LOGPASS), das dann von den 
Kommunikationspartner angegeben 
werden muß. 


Verweis auf das Kennzeichen einer 
Contingency-Routine, das bei Angabe 
eines ENACO-Aufrufs erzeugt wurde. 
Wird die Meldung gegeben, wird diese 
Routine zum Ablauf gebracht. 
Hinweis: für COBOL nicht notwendig 


Angabe der DCAM-Versionsnummer 
(DCAMVER) . 


Beschreibung der einfach benutzbaren DCAM-Anwendung 


Bei COBOL muß der Name der DCAM-Anwendung immer vom Benutzer angegeben werden. 
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3.1.1.2 Erstmaliges Eröffnen einer mehrfach benutzbaren DCAM-Anwendung 


Eine mehrfach benutzbare DCAM-Anwendung kann in mehreren Prozessen eröffnet werden. 
Der erste Prozeß, der sie eröffnet, ist der Primärprozeß. Standardmäßig erfolgt Nachrichten- 
verteilung nicht über Verteilcodes (SHARE, NDISCO). Es werden also die absenderspezifi- 
schen oder die empfängerglobale Warteschlange (n) alleine herangezogen. Der Name der 
DCAM-Anwendung muß im Programm festgelegt werden, für weitere Festlegungen in 


Abhängigkeit von verschiedenen Faktoren siehe Tabelle 3-2. 


Voraussetzung(en) 


Der Prozeß soll in jedem Fall der 
erstöffnende sein, weil er Funktionen 
eines Primärprozesses erfüllen soll. 
Ist er es nicht, soll der YOPEN 
zurückgewiesen werden. 


Es kann als sichergestellt gelten, 
daß der Prozeß der ersteröffnende ist 
oder alle sich anschließenden Pro- 
gramme haben gleiche Verarbeitungs- 
logik. 


Unbefugtes Anschließen von Sekundär- 
prozessen kann nicht ausgeschlossen 
werden, daher soll es verhindert 
werden. 


Es muß geklärt sein, ob die DCAM- 
Anwendung nur Aufforderungen zum 
Verbindungsaufbau ausgibt. Voraus- 
setzung dafür ist, daß alle möglichen 
Partner entweder Datenstationen sind 
oder DCAM-Anwendungen, die Auffor- 
derungen bearbeiten. | 


Im Programm ist nicht bekannt, ob und 
wann ein Partner sich anschließen 
will, bzw. der Partner selbst ist 
nicht bekannt. 


Unbefugte Aufforderungen zum Aufbau 
einer Verbindung sollen automatisch 
zurückgewiesen werden. 
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Festlegung 


Überprüfung mit VERIFY = PRIMARY. 


Keine Überprüfung, 
also 
VERIFY = NO. 


Kennwort USEPASS, das dann von den 
Sekundärprozessen beim nachfolgenden 
Eröffnen angegeben werden muß. 


Hinweis: 


Ist die DCAM-Anwendung bereits 

durch ein Kennwort (APPPW=, siehe 
"Generierung eines Datenkommunika- 
tionssystems’) in der Netzdatei RDF 
geschützt, so muß das USEPASS-Kenn- 
wort ggf. mit dem APPPW-Kennwort 
übereinstimmen. Der Parameter USEPW 
wird dann auch beim Primärprozeß 
ausgewertet; er muß das RDF-Kennwort 
enthalten. 


Attribut NLOGON: 
Aufforderungen zum Verbindungsaufbau 
werden nicht bearbeitet. 


Attribut LOGON: 
Aufforderungen zum Verbindungsaufbau 
werden bearbeitet. 


Kennwort (LOGPASS), das dann von den 
Kommunikationspartnern angegeben 
werden muß. 


Hinweis: 

LOGPASS und USEPASS können in 
einer bestehenden DCAM-Anwendung 
nicht geändert werden. 


3.1.1.3 


Voraussetzung(en) 


Transportquittungen für diese Anwen- 
dung werden generell im Primärprozeß 
bearbeitet. 


Transportquittungen werden von dem 
Prozeß bearbeitet, der unter der 
entsprechenden Laufnummer (SEQNO) die 
Nachricht abgesendet hat. 


Diese Anwendung verarbeitet grund- 
sätzlich keine Transportquittungen, 
weil anwenderspezifische Sicherungs- 
verfahren eingesetzt werden sollen. 


Es sollen neue Funktionen einer DCAM- 
Version (ab 8.0) benutzt werden. 


Es sollen asynchrone Meldungen ange- 
nommen werden. 


Tabelle 3-2 
durch den Primärprozeß. 


Festlegung 


Eigenschaft PRIMTASK für die Zu- 
stellung von Transportquittungen. 


. Eigenschaft REQTASK für die Zustel- 


lung von Transportquittungen. 


Eigenschaft NOTACK, keine Zustellung 
von Transportquittungen, weder posi- 
tiven noch negativen. 


Angabe der DCAM-Versionsnummer 
(DCAMVER) 


Verweis auf das Kennzeichen einer 
Contingency-Routine, das bei Abgabe 
eines ENACO-Aufrufs erzeugt wurde. 
Wird die Meldung gegeben, wird diese 
Routine zum Ablauf gebracht. 
Hinweis: für COBOL nicht notwendig 


Beschreibung der mehrfach benutzbaren DCAM-Anwendung bei Eröffnung 


Erstmaliges Eröffnen - Verwendung von Verteilcodes 


Der Primärprozeß, der eine DCAM-Anwendung eröffnet, kann wahlweise festlegen, daß 
anstelle des Standardverfahrens mit der Nachrichtenverteilung anhand von Verteilcodes 
gearbeitet wird (SHARE,DISCO). Dies ist insbesondere dann günstig, wenn die beteiligten 
Programme unterschiedliche Aufgaben erfüllen, aber von einer gemeinsamen Anzahl von 
Partner angesteuert werden. Zu diesem Zweck müssen von allen beteiligten Prozessen 
Verteilungsnamen definiert werden, die eine Zuordnung von Verteilcode(s) und Prozeß 
erlauben (DISNAME). Für weitere Festlegungen gilt ebenfalls die Tabelle 3-2. 
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3.1.1.4 


3.1.1.5 


Nachfolgendes Eröffnen 


Ein Prozeß, der als nachfolgender eine DCAM-Anwendung eröffnet, muß sich in den Festle- 
gungen nach dem Primärprozeß richten. So muß er den dort festgelegten Namen der 
DCAM-Anwendung verwenden und ebenfalls ATTR=SHARE setzen (mehrfach verwendbare 
DCAM-Anwendung). Im Standardfall wird er mit Nachrichtenverteilung über die absender- 
spezifische oder empfängerglobale Warteschlange arbeiten. Weitere Festlegungen sind in 


Tabelle 3-3 gezeigt. 


Voraussetzung(en) 


Der Primärprozeß hat zum Schutz gegen 
unbefugten Anschluß ein Kennwort 
festgelegt oder die Anwendung ist 
durch ein RDF-Kennwort geschützt. 


Der Prozeß muß in jedem Fall der 
nachfolgend eröffnende sein, denn in 
der Programmlogik ist dies so vorge- 
sehen, ggf. soll der YOPEN zurück- 
gewiesen werden. 


Es kann garantiert werden, daß der 
Prozeß der nachfolgend eröffnende 

ist, bzw. die Programmlogik prüft 

ihrerseits diese Vorausetzung. 


Es sollen asynchrone Meldungen ange- 
nommen werden. 

Einschränkung: 

An der COBOL-Schnittstelle gibt es 
keine asynchronen Meldungen, 

die an den Sekundärprozeß gehen. 


Der Primärprozeß hat beim Eröffnen 
der Anwendung eine DCAM-Versions- 
nummer angegeben. 


Tabelle 3-3 
durch den Sekundärprozeß. 


Festlegungen 


Kennwort (USEPW) zum Anschluß an 
die DCAM-Anwendung, wie im Primär- 
prozeß oder in der RDF angegeben. 


Überprüfung mit 
VERIFY = SECONDARY. 


Keine Überprüfung, also 
VERIFY = NO. 


Verweis auf das Kennzeichen einer 
Contingency-Routine, das bei Abgabe 
eines ENACO-Aufrufs erzeugt wurde. 
Wird die Meldung gegeben, wird diese 
Routine zum Ablauf gebracht. 


Angaben der gleichen DCAM- 
Versionsnummer wie beim Primär- 
prozeß (DCAMVER) 


Beschreibung der mehrfach benutzbaren DCAM-Anwendung bei Eröffnung 


Nachfolgendes Eröffnen - Verwendung von Verteilcodes 


Bei einem nachfolgenden Eröffnen der DCAM-Anwendung muß auch die Nachrichtenvertei- 
lung nach dem ersteröffnenden (Primärprozeß) ausgerichtet werden. Sie ist also stets für die 
Prozeßgruppe einheitlich. Bei dieser Variante wird mit Verteilcodes gearbeitet, im Primärpro- 
zeß werden also die Attribute SHARE und DISCO angegeben. Im Sekundärprozeß muß der 
gleiche Name der DCAM-Anwendung und das Attribut SHARE angegeben werden. Des 
Weiteren muß ein Name definiert werden (DISNAME), der für die Verteilcode-Zuordnung 
gebraucht wird. Alle weiteren Festlegungen sind der Tabelle 3-3 zu entnehmen. 
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3.1.2 


Verändern des Zustands einer DCAM-Anwendung 


Die unterschiedlichen Zustände einer DCAM-Anwendung werden in Bild 3-1 gezeigt. 


Erstmaliges 


Eröffnen 


Andern des 
Zustands der 
DCAM-An- 
wendung 

mit YSETLOG 


Schließen durch START 
den Primärprozeß 


L Erstmaliges 


| 
| et p 
L Schließen 


durch den 
Primärprozeß 


Bild 3-1 Zustände der DCAM-Anwendung 


Eine DCAM-Anwendung kann so angelegt sein, daß sie keine Aufforderungen zum Verbin- 
dungsaufbau bearbeitet (Attribut NLOGON). Dieses Attribut kann für eine bestehende DCAM- 
Anwendung nicht mehr geändert werden. 


Sollen hingegen solche Aufforderungen bearbeitet werden (Attribut LOGON), kann zeitweise 
verhindert werden, daß dies geschieht. 


Aufforderungen zum Verbindungsaufbau werden der DCAM-Anwendung gemeldet, ggf. 
wenn mehrere eintreffen in einer Warteschlange verbucht, bis der Primärprozeß mit dem 
Aufruf YSETLOG mitteilt, daß er solche Meldungen nicht mehr bearbeiten will (STOP) - 
vielleicht, weil er das Höchstmaß zulässiger Verbindungen erreicht hat - vielleicht, weil er für 
eine bestimmte Zeit selbst Aufforderungen ausgeben will. Ändert sich die Voraussetzung, 
kann er jederzeit wieder den ursprünglichen Zustand herstellen, d.h. Aufforderungen werden 
nicht mehr zurückgewiesen, sondern ihm zugestellt, bzw. in die Warteschlange eingereiht 
(START). 
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Abfragen des Zustands einer DCAM-Anwendung 


Mit dem Aufruf YINQUIRE hat der Benutzer die Möglichkeit, sowohl den Zustand der 
DCAM-Anwendung, die er selbst eröffnet hat, abzufragen, als auch den Zustand einer 
DCAM-Anwendung, die im selben Verarbeitungsrechner eröffnet wurde und deren Name er 
kennt. 


Er benutzt dazu die Variante ‘APPSTAT’ des Aufrufs YINQUIRE. 


Schließen einer DCAM-Anwendung 


Die DCAM-Anwendung kann auf zwei Arten geschlossen werden: 


e implizit durch Beenden des Programms, in dem die DCAM-Anwendung eröffnet wurde 
(durch normales oder fehlerbedingtes Ende), bzw. Abbruch des Prozesses; 


e explizit durch den Aufruf YCLOSE, bzw. durch Kommandos /SHUTDOWN oder /BCLOSE 
des Operateurs. 


Das explizite Schließen durch YCLOSE wird dann erforderlich sein, wenn z.B. in einem 
Programm nacheinander mit mehreren DCAM-Anwendungen gearbeitet werden soll, oder 
aber, wenn während des Ablaufs Festlegungen geändert werden sollen. Nach dem Schließen 
kann die Anwendung mit neuen Festlegungen (Namen, Eigenschaften, usw.) (siehe auch 3.4 
Namen-Zuweisungsfunktion) durch den Primärprozeß wieder eröffnet werden. 


Der Sekundärprozeß kann jederzeit die Anwendung schließen, ohne weitere Folgen für die 
übrigen Prozesse der Gruppe. 


Das Schließen durch den Primärprozeß jedoch bewirkt, daß 
e die DCAM-Anwendung aufgelöst wird. 


e Sekundärprozesse unterrichtet werden durch Anstoßen der COMEND-Contingency- 
Routine (siehe auch 4.1.5) oder durch eine entsprechende Rückmeldung beim nächsten 
Aufruf oder einem noch nicht beendeten Befehl. 


e Alle bestehenden Verbindungen abgebaut werden. 


Dies bedeutet auch, daß bereits angekommene, aber noch nicht übergebene Daten nicht 
mehr erreichbar sind. Bereits wartende Aufforderungen zum Verbindungsaufbau werden 
gelöscht. 
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3.2 


Verbindungsfunktion 


@ Der Partner kann auch diese Warteschlange abfragen, ohne eine Meldung erhalten zu 
haben (siehe auch 3.2.1.3 und Kapitel 4), um festzustellen, ob Eintrage vorliegen. Abhangig 
vom Ergebnis wird er Annahmeaufrufe fiir diese Aufforderung ausgeben (YOPNCON 
ACCEPT SPEC) (Bild 3-4). 


e Erkann auch die Aufforderung zurückweisen, bzw. durch Nichtannahme dafür sorgen, daß 
nach einer im System definierten Zeit (Kommando /BCTIMES, siehe Generierung und 
Administration) die Aufforderung gelöscht wird. 


Partner 1 Partner 2 


Bild 3-4 Abfragen Partnerinformation und Annahme der Aufforderung 


e Erhatferner die Möglichkeit, ohne abzufragen, sozusagen auf Verdacht, Annahmeaufrufe 
abzugeben. Trifft in einer bestimmten, angegebenen Zeit die Aufforderung ein, wird sie 
angenommen. Mehrere solche Annahmen ‘auf Verdacht’ werden, falls die Aufforderun- 
gen noch nicht da sind, in eine Warteschlange eingetragen. Sie können für einen 
bestimmten (SPEC) oder beliebige Partner (ANY) ausgegeben werden (Bild 3-5). 


Partner 1 Partner 2 


EEE FE 


Bild 3-5 Annahme der Aufforderung 


e Eine weitere Möglichkeit ist die Zuordnung von Partnernamen zu einer DCAM-Anwendung 
bereits beim Generieren und Starten des Kommunikations-Zugriffssystems (siehe 
Makro XSTAT in Generierung und Administration). Wird die DCAM-Anwendung eröffnet, 
bzw. ein /BCIN-Kommando vom Administrator gegeben, das den Prozessorknoten des 
vorgeschlagenen Partners betrifft, werden ihr diese Partner zum Verbindungsaufbau 
vorgeschlagen. Dies geschieht durch die PROCON-Meldung. Aufgrund der Meldung muß 
eine Aufforderung ausgegeben werden (YOPNCON ACQUIRE). Erst wenn diese vom 
vorgeschlagenen Partner angenommen wurde, ist die Verbindung aufgebaut (Bild 3-6). 


Einschränkung: 


An COBOL-Programme werden keine PROCON-Meldungen gegeben. 


Partner 2 


PROCON-Routine 


Partner 1 


Bild 3-6 PROCON-Meldung, Aufforderung an vorgeschlagene Partner und Annahme 


e Beim Generieren und Starten des Kommunikations-Zugriffssystems kann man nicht nur 
Verbindungsvorschläge, sondern auch Verbindungen selbst vordefinieren (Makro XKON). 


Diese Verbindungen sind bereits aufgebaut, wenn das Kommunikations-Zugriffssystem 
gestartet wird. Datenübermittlung ist aber erst dann möglich, wenn der Primärprozeß 
einen Aufruf abgibt, mit dem er sonst einen Verbindungswunsch äußert (YOPNCON 
ACQUIRE). 


Ist der Partner eine Datenstation, genugt es, wenn diese eingeschaltet und betriebsbereit 
ist. 


Jeder Kommunikationspartner, der einen Aufruf zum Aufbau einer Verbindung ausgibt, 
beschreibt die von ihm gewünschten Eigenschaften der Verbindung. Bei der Aufforderung 
zum Verbindungsaufbau werden die Eigenschaften, die den Partner betreffen, diesem mitge- 
teilt. Dies sind: 


e Verwendung eines Datenübermittlungsprotokolls (DEPROT); 
Einschränkung: 


In DCAM V8.0 noch nicht vom System unterstützt. 
e Art der verwendeten Nachrichtenaufbereitung (EDIT); 


e Festlegung, wer mit der Datenübermittlung beginnt (PROC). 
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Bild 3-7 zeigt, wie diese Informationen abgefragt und festgelegt werden: 


Partner 1 fordert Partner 2 zum Verbindungsaufbau auf (YOPNCON ACQUIRE). Er macht 
Partner 2 Vorschläge für EDIT und PROC. Partner 2 hat 2 Möglichkeiten, auf den Aufruf von 
Partner 1 zu reagieren: 


e Er fragt die Vorschläge von Partner 1 ab (YINQUIRE) und prüft sie, um sie dann 
anzunehmen oder abzulehnen, d.h., andere Werte für EDIT und PROC an Partner 1 
zurückzuschicken (YOPNCON ACCEPT). 


e Er schickt gleich seine eigenen Werte für EDIT und PROC an Partner 1, ohne dessen 
Vorschläge zu betrachten. 


% 


Für Partner 1 sind in jedem Fall die Werte bindend, die Partner 2 geschickt hat. Die von Partner 
1 vorgeschlagenen Werte für EDIT und PROC brauchen also nicht mit den aktuellen Werten 
übereinstimmen. Daher muß sich der Benutzer nach Aufbau der Verbindung vergewissern, 
welche Werte aktuell sind. 


Sowohl bei einer Aufforderung zum Verbindungsaufbau (YOPNCON ACQUIRE) als auch bei 
der Annahme der Verbindung (YOPNCON ACCEPT) können beide Partner einander Verbin- 
dungsnachrichten zukommen lassen. 


Wenn eine Verbindung vordefiniert wurde, sind ihre Eigenschaften bei der Systemgenerie- 
rung festgelegt worden. 


Partner 1 Partner 2 


Bild 3-7 Abstimmung über Eigenschaften 
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3.2.1.1 Beschreibung der aufzubauenden Verbindung 


Die Verbindung, die aufgebaut werden soll, mu& im DCAM-Programm beschrieben werden. 
Folgende Angaben sind dazu notwendig: 


e Name und Prozessorname (= Adresse) des Partners. 


Mit dieser Angabe wird ein Partner adressiert, wenn eine Aufforderung ausgegeben wird 
oder von einem bestimmten Partner (SPEC) eine Aufforderung angenommen wird. 


Wurde eine Annahme für einen beliebigen Partner (ANY) ausgegeben, wird nach 
Abschluß des Aufrufs von DCAM der Partner- und Prozessorname zurückgegeben. 


e Begleitinformation 


Hier legt der Benutzer eine beliebige Zeichenfolge fest, die er z.B. bei jedem Empfang von 
Nachrichten über diese Verbindung mitgeliefert bekommt. Es kann die Adresse eines 
Datenbereichs sein, der dieser Verbindung zugeordnet werden soll oder die Adresse einer 
Routine, die speziell für diese Verbindung angesprungen werden soll. Beim Zugriff auf die 
empfängerglobale Warteschlange mit YRECEIVE ANY ist dieses Verfahren besonders 
hilfreich, aber auch bei verteilcodespezifischem Zugriff, wenn mehrere Prozesse den 
gleichen Verteilungsnamen benutzen (siehe auch 3.2. 1.4). 


Der Inhalt der Begleitinformation ist frei wählbar. 
Sie darf nicht länger als 4 Bytes sein. 


Einschränkung: 


In COBOL kann die Begleitinformation nicht definiert werden. 


e Behandlung zu langer Nachrichten 


Abhängig von der Problemstellung muß hier zwischen zwei Möglichkeiten eine Wahl 
getroffen werden, siehe dazu Tabelle 3-4. 


Dieser Eintrag kann später, bei Ausführung eines Empfangsaufrufs (siehe 3.3.2), wieder 
geändert werden. 


` 


Voraussetzung (en) Festlegungen 


- Es werden über diese Verbindung nur | Es wird für PROC der Wert TRUNC 


Nachrichten fester Länge erwartet. angegeben. 

- Eine Nachricht, die länger ist als Nachrichten, die langer sind als 
erwartet, kann nur fehlerhaft sein. erwartet, werden nur in der erwarte- 
Darum soll die Überlänge wegge- ten Länge übergeben. Die Über- 
worfen werden. länge wird zwar angezeigt, aber 

weggeworfen. 

- Es ist nicht vorhersehbar in Es wird für PROC der Wert KEEP ange- 
welcher Länge die Nachrichten geben. Die Überlänge einer Nach- 
über diese Verbindung eintreffen. richt wird beim Empfang des 1. Teils 
Es wird darum die häufigst ver- angezeigt. Sie wird für. einen wei- 
mutete Länge angegeben und es wird teren Empfangsaufruf aufgehoben. 


der Eingabebereich dafür reserviert. 

- Die mögliche Überlänge soll nicht 
weggeworfen werden, sondern soll 
mit einem weiteren Empfangsaufruf 
abgeholt werden. 


Tabelle 3-4 Behandlung zu langer Nachrichten 
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e Code der Nachrichten 
Da in einem Datenkommunikationssystem auf den Teilstrecken der Ubertragung mit 
unterschiedlichen Codes gearbeitet werden kann, wird hier dem Benutzer überlassen, sich 
nach seiner Problemstellung zu entscheiden; hierzu gibt Tabelle 3-5 eine Übersicht. 
Voraussetzung(en) Festlegungen 


Der Benutzer arbeitet mit Logischen | Es wird für PROC der Wert SYSCODE 


Datenstationen zusammen. eingestellt. Die Nachrichten werden, 
Er möchte die Nachrichten immer im falls erforderlich, im Datenkommu- 
Code des eigenen Verarbeitungsrech- | nikationssystem übersetzt. 


ners bekommen (in der Regel EBCDIC). 
Er sendet Nachrichten immer im Code 


des eigenen Verarbeitungsrechners. 


Der Benutzer arbeitet nicht mit Es wird für PROC der Wert BINARY 
Logischen Datenstationen zusammen. angegeben. Die Nachrichten werden 
Er möchte Nachrichten in dem Code in jedem beliebigen Code (transpa- 
erhalten, den der Kommunikations- rent) übermittelt. 


partner benutzt. 
Er sendet Nachrichten in dem Code, 


den der Partner verarbeiten kann. 


Tabelle 3-5 Code der Nachrichten 


Datenflußkontrolle 

Auf einer Verbindung kann es zu einer Überlastung kommen, bei der keine Nachrichten 
zugestellt werden können. 

Der Benutzer hat die Möglichkeit, sich durch ein GO-Signal informieren zu lassen, wann 
die Verbindung wieder frei ist und Daten erneut gesendet werden können (SIGNAL). 


Das Kennwort zum Verbindungsaufbau wird angegeben, wenn eine Aufforderung zum 
Verbindungsaufbau gestellt werden soll. Es muß so angegeben werden, wie es der Partner 
(in diesem Fall eine DCAM-Anwendung) beim Eröffnen definiert hat (siehe 3.1.1.1). 


Wenn mit Nachrichtenverteilung anhand von Verteilcodes gearbeitet wird, muß der 
Verweis auf die weitere Beschreibung dieser Verteilcodes hier gegeben sein. Dies wird 
unter 3.2.1.4 ausführlich im weiteren Zusammenhang gezeigt. 


Die maximale Länge der Daten (MAXLN) die auf dieser Verbindung gesendet werden 
sollen. Sie ist ein Wert, der der Optimierung der vom System bereitgestellten Puffer dient; 
sie wird nicht an den Kommunikationspartner weitergegeben. 


Eigenschaften von Nachrichten, die mit dem Partner abgestimmt werden. 


Über einige Eigenschaften müssen sich, wie bereits im vorigen Abschnitt erwähnt, die 
beiden Partner verständigen. Diese werden ebenfalls hier beschrieben: 


Der Beginn der Datenübermittlung wird festgelegt. Soll die DCAM-Anwendung mit der 
Übermittlung beginnen, wird APPSTART festgesetzt. Ansonsten gilt keine Festlegung 
(ANYSTART). 


Die Art der verwendeten Nachrichtenaufbereitung wird festgelegt. Welche Möglichkeiten 
bestehen, wird in Bild 3-8 im Überblick gezeigt (vgl. dazu auch 2.3.4). 


Hinweis: 


Bei Verbindungen mit EDIT=SYSTEM wird im Fall ATTR=DISCO der Verteilcode stets im 
LINE-Modus aufbereitet. 
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Der Partner ist eine Datenstation 


und es sollen (evtl. spater) 
logische Datenstationen benutzt werden. 


Eingabe 


EDITIN = 


Ausgabe 
EDITOUT = 
LINE 


(Verwendung der Zeilen-Datenstation) 


FORM 
(Verwendung der Format-Datenstation) 


ete PHYS’) —- 
(keine Verwendung Logischer Datenstationen) i 


Nachrichtenbehandlung 


Übergabe vom 
Rückwärtsschritt 
(backspace)-Zeichen 


Funktionstastencode 


NLCASE 
NHCOPY 


NEXTEND 


NLOG 
6) 
LACK NLACK 
Der Partner ist eine Anwendung, 


so daß eine Nachrichtenaufbereitung entfällt 


Groß- und Kleinschreibung 


Protokolldrucker (hardcopy) 


Unstrukturierte (r) 
Ausgabe 


Die Ausgabedaten sind durch 
das System geschützt 


Alle logischen Steuerzeichen 
einer Nachricht werden aus- 
gewertet und in Geräte-Steue 
zeichen umgesetzt 

(Druckerunterstützung) 


LOGC 


Es werden logische 
Quittungen von der 
Druckerstation angefordert 


_ EDIT = USER 
1 evtl. vorhandene Nachrichtenköpfe 2) nur bei Schreibstationen 8103 
werden im Gerätecode, die Nachrichten 3) nur mit EDITIN = LINE 
im EBCIDIC übergeben/übernommen; 4) nur mit EDITIN = LINE/FORM 
eine Nachricht kann in Teilnachrichten 5) nur mit EDITOUT = LINE/PHYS und bei Geräten 8151, 


aufgeteilt werden (siehe Tabelle 3-7 in 3.3.1) 8152 und 816X 

6) nur mit EDITOUT = LINE 

7? nur mit EDITOUT = LINE und bei Geräten 975X und 816 X 
Bild 3-8 Möglichkeiten der Nachrichtenaufbereitung 
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3.2.1.2 


Auffordern zum Aufbau 


Zum Verbindungsaufbau aufgefordert werden kann jeder beliebige Partner im Datenkommu- 
nikationssystem. Ist der Partner eine Datenstation, wird der zugehörige Prozessor (z.B. ein 
Netzknotenrechner) die Aufforderung beantworten. Im anderen Fall wird das Kommunikati- 
ons-Zugriffssystem im BS2000 reagieren (siehe auch 3.1.1.1 und 3.1.2) bzw. der Partner (in 
diesem Fall eine DCAM-Anwendung) selbst. Für den Prozessorknoten an dem eine Datensta- 
tion angeschlossen ist, gibt es zur Zeit zwei Möglichkeiten: 


e Erhält er eine Aufforderung für eine Datenstation, die nicht erreichbar ist (ausgeschaltet 
bei Standverbindung, nicht frei bei Wählverbindung, u.ä.), wird er sie zurückweisen. 


e Ist die Datenstation erreichbar, wird vorausgesetzt, daß auch eine Bedienungsperson 
vorhanden ist, und die Verbindung wird aufgebaut (der Prozessorknoten nimmt die 
Aufforderung an). 


Das Kommunikations-Zugriffssystem im BS2000 unterscheidet nach unterschiedlichen 
Merkmalen. Die Übersicht auf Bild 3-9 zeigt, daß hier der Benutzer von DCAM mehrere 
Möglichkeiten der Steuerung hat, des Weiteren im Programm selbst, wenn er die Aufforde- 
rung bearbeitet. Für eine Prüfung oder auch nur zur einmaligen Übermittlung kann eine 
Verbindungsnachricht mit der Aufforderung übergeben werden. 

Diese Nachricht kann einen beliebigen Inhalt haben und eine Maximallänge von 80 Bytes. Sie 
ist die einzige Nachricht, die ohne eine schon bestehende Verbindung übermittelt wird. 


Ein Partner, der eine Aufforderung abgeben will, macht folgende Angaben: 


e die Adresse des Partners (Partner und Prozessorname), an den die Aufforderung gerichtet 
wird. | 


Beschreibung der Eigenschaften der Verbindung (siehe 3.2.1.1). 
Kennwort zum Verbindungsaufbau, falls gefordert. 


wahlweise eine Verbindungsnachricht, die er mit der Aufforderung übermitteln will. 


die Nachrichtenverteilung (wenn ohne Verteilcodes gearbeitet wird). Er bestimmt damit, 
ob er die folgenden Nachrichten dieser Verbindung empfängerglobal oder absenderspezi- 
fisch empfangen möchte. 

Diese Angabe kann bei der Datenübermittlung wieder geändert werden. 


Wurde die Aufforderung angenommen, erhält er als Rückinformation: 
e Die Begleitinformation, die er festgelegt hat (siehe 3.2.1.1). 


e Die endgültige Festlegung der Nachrichtenlänge, die auf dieser Verbindung übermittelt 
werden (siehe 3.2.1.1 MAXLN-Parameter). 


e Die endgültige Festlegung für DEPROT, PROC, EDIT. 


e Partnercharakteristika (Art des Partners). 


DCAM V8.0A DCAM Programmschnittstellen, U1786-J-Z75-1 


Die Möglichkeit, den in diesem Aufruf enthaltenen Befehl asynchron ausführen lassen zu 
können, wird bei der Beschreibung der Sprach-Eigenheiten (siehe z.B. 4.1.3) erläutert. 


Einschränkung: 


Verbindungsnachrichten werden nur DCAM-Anwendungen zugestellt. Datenstationen, die an 
Kommunikationsrechner TRANSDATA 960 angeschlossen sind, können keine Verbindungs- 
nachricht erhalten. 


Übermittlung durch das 
Datenkommunikations- 
system 


*) siehe Abschnitt 3.2.1.1 


Bild 3-9 Bearbeitung einer Aufforderung 
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3.2.1.3 


Annahme einer Aufforderung 


Die grundsätzliche Beschreibung der Annahme ist bereits in den vorigen Abschnitten enthal- 
ten. Zusammenfassend wird hier aufgezählt, welche Angaben gemacht werden können, wenn 
eine Annahme ausgegeben wird. Die einzelnen Angaben in ihrer gegenseitigen Abhangigkeit 
zeigt das Bild 3-10. 


Annahme der Aufforderung 


eines bestimmten Partners 


eines beliebigen Partners 
(ANY) 


Adresse des Partners 
(Name und Prozessorname) 


der Verbindung 


nur, wenn Nachrichtenverteilung 
nicht über Verteilcodes 


Festlegung der Eigenschaften 


Verbindungsnachricht,die 4 
übermittelt werden soll 
(wahlweise ab DCAMVER 8.0) 


Nachrichtenverteilung über empfänger- 
globale (CA) oder absenderspezifische 


Warteschlange (CS) 


| asynchrone Verarbeitung*) 


Li me m me un um m u my 


wahlweise 


Eintrag in eine Warteschlange (Q) 
mit maximaler Verweilzeit (TOVAL) 


*) weitere Angaben 
siehe Abschnitt 4.1.3 


Bild 3-10 Angaben zur Annahme einer Aufforderung 
Nachdem der Aufruf ausgeführt wurde, erhält der Prozeß: 


e die endgültig Festlegung der Nachrichtenlänge auf dieser Verbindung (siehe Abschnit 
3.2.1.1 MAXLN-Parameter) und 


e Partnercharakteristiken (wesentliche Merkmale) mitgeteilt. 

Ferner, wenn die Aufforderung eines beliebigen Partners angenommen wurde: 
e den Namen des Partners und 

e den Prozessornamen des Partners 


e die Begleitinformation 
(siehe auch 3.2.1.1). 
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3.2.1.4 


Aufbau einer Verbindung - Verwendung von Verteilcodes 


Wenn die Nachrichtenverteilung anhand von Verteilcodes erfolgen soll (definiert beim 
Eröffnen der Anwendung), sind bereits beim Aufbau einer Verbindung wesentliche Festlegun- 
gen zu treffen. 

Wie bereits erwahnt (siehe 3.2.1.1), ist in der Beschreibung einer Verbindung in diesem Fall ein 
Verweis auf den Teil enthalten, der die Verteilcodes beschreibt. Die Beschreibung der 
Verteilcodes erfolgt in 2 Stufen (siehe Bild 3-12), um in der Zuordnung der Verbindung zu den 
Verteilcodes möglichst viel Spielraum zu bieten: 


1. Stufe Beschreibung der Codeposition in der Nachricht und der Länge des/der 
verwendeten Codes. Der Code muß in den ersten 256 Bytes der Nachricht 
enthalten sein und kann maximal 8 Bytes lang sein. 


Ferner: Verweis auf die Beschreibung der 2. Stufe, die maximal 8-mal 
(COBOL) oder 16-mal (Assembler) vorhanden sein kann. 


2. Stufe Beschreibung der Codes, wie sie von dieser Verbindung benutzt werden. 
Es können maximal 8 Codes beschrieben werden. 


Diese Beschreibungen können mehrfach benutzt werden, d.h. - es können mehrere Verbin- 
dungen die gleiche Beschreibung der 1. Stufe verwenden und es können mehrere Beschrei- 
bungen der 1. Stufe eine Beschreibung der 2. Stufe verwenden. 


Zu beachten ist folgendes: 


e Die Codes, welche durch diesselbe Beschreibung der Stufe 1 adressiert werden, müssen 
eindeutig sein und 


e müssen alle die gleiche Länge haben. 


e Adressieren mehrere Beschreibungen der Stufe 1 eine Beschreibung der Stufe 2, müssen 
die Längenangaben in den Beschreibungen der Stufe 1 übereinstimmen. 


Durch dieses Verfahren der Verteilcodebeschreibung beim Aufbau einer Verbindung ergeben 
sich folgende Möglichkeiten: 


e Codelange und Codeposition in der Nachricht sowie Codeanzeiger werden beim Verbin- 
dungsaufbau festgelegt und sind für eine bestehende Verbindung nicht veränderbar. 


e Von einem Partner können maximal 64 (COBOL) bzw. 128 (Assembler) unterschiedliche 
Verteilcodes in Gruppen zu je 8 angegeben werden. Er erreicht damit einesteils einen 
Prozeß über maximal 8 verschiedene Codes, andererseits eine unterschiedliche Anzahl 
von Prozessen. 


Unterschiedlich ist die Anzahl deshalb, weil die Zuordnung von Codes und Prozeß über den 
Verteilungsnamen während des Ablaufs erfolgt. Diese Zuordnung wird vom Primärprozeß 
durch die Aufrufe YPERMIT und YFORBID gesteuert (siehe 3.3.5). 
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3.2.1.5 


Beschreibung der 
Verteilcodes 


Stufe 1: 
Formate 


Stufe 2: *) 
Werte 


*) die Codes der Gruppen 1-5 und 4-8 müssen 
jeweils eindeutig sein 


Bild 3-11 Beispiel für Beschreibung der Formate und Werte von Verteilcodes 


Anschließen an eine vordefinierte Verbindung 


Eine vordefinierte Verbindung wird beim Generieren des Kommunikations-Zugriffssystems 
festgelegt. Sie ist aufgebaut, wenn das Kommunikations-Zugriffssystem gestartet wird. Bevor 
aber Datenübermittlung möglich ist, müssen sich die beiden Partner erst der vordefinierten 
Verbindung anschließen. 


Dazu müssen bei Anwendungen die Primärprozesse einen Verbindungswunsch abgeben 
(YOPNCON ACQUIRE). Bei einer Datenstation genügt es, wenn diese eingeschaltet und 
betriebsbereit ist. 


Da die Eigenschaften einer vordefinierten Verbindung beim Generieren des Kommunikations- 
Zugriffssystems festgelegt werden und die Verbindung bei dessen Start automatisch aufge- 
baut wird, gibt es einige Besonderheiten: 


e Senden von Daten, bevor der Partner sich der Verbindung angeschlossen hat, führt zu 
negativen Transportquittungen. 


e Es wird keine LOSCON-ROUTINE angestoßen, wenn ein Partner sich von der Verbindung 
zurückziehen will (die vordefinierte Verbindung bleibt nämlich weiter aufgebaut). 


e Ein YOPNCON ACCEPT SPEC auf einen vordefinierten Partner wird nie erfolgreich 
beendet. Ist OPTCD=Q angegeben, wird der Aufruf in eine Warteschlange eingetragen 
und durch TIMEOUT beendet. 
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3.2.2 


Folgende Angaben können bei einem YOPNCON ACQUIRE bei vordefinierten Verbindungen 
nicht gemacht werden: 


e Verbindungsnachricht 

LOGON-Paßwort 

Vereinbarungen über Datenübertragungsprotokoll (DEPROT) 

Nachrichtenaufbereitung durch das System oder den Benutzer (EDIT=SYSTEM/USER) 
Start der Datenübermittlung (PROC = APPSTART/ANYSTART). 


Bild 3-12 Anschließen an eine vordefinierte Verbindung 


Abfragen der Einträge über Partner und Verbindungen 


Wie schon beim Auffordern zum Verbindungsaufbau und der Annahme einer Aufforderung ` 
deutlich wurde, ist ein Abfragen von Einträgen über Partner und Verbindungen notwendig. 
Dazu stehen 6 Varianten des Aufrufs YINQUIRE zur Verfügung. Für Sekundärprozesse sind 
nur die Varianten CIDXLATE, NAMXLATE und PTNCHAR möglich. 


Einschränkung: 


Mit COBOL stehen nur 3 Varianten des YINQUIRE zur Verfügung. 
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3.2.3 


Tabelle 3-6 zeigt die Möglichkeiten des YINQUIRE in Abhängigkeit von der verwendeten 
Programmiersprache. 


Abfrage Variante des YINQUIRE Programmiersprache 


— Welcher Partner fordert Abfrage nach einer Assembler 
zur Verbindung auf? asynchronen LOGON- 
- Wie lauten die vorge- Meldung 
schlagenen Eigenschaften (REQLOGON) 
der Verbindung? 
— Welche Verbindungsnach- 
richt wird übermittelt 
und in welcher Länge? 
— Welcher Partner ist der Abfrage vor Annahme Assembler /COBOL 
nächste in der Warte- einer Aufforderung 
schlange derer, die zur (TOPLOGON ) 
Verbindung auffordern? 
— Wie lauten die vorge- 
schlagenen Eigenschaften 
der Verbindung? 
- Welche Verbindungsnach- 
richt wird übermittelt 
und in welcher Länge? 
— Welche charakteristischen | Abfrage der Partner- Assembler /COBOL 
Merkmale hat der Partner? | charakteristika 
(PTNCHAR) 
- Von wievielen Partnern Abfrage der Partneran- Assembler /COBOL 
liegt eine Aufforderung zahl 
vor? (COUNTPTN) 
— Mit wievielen Partnern 
wurde eine Verbindung 
aufgebaut? 
- Wie lautet das Kennzeichen| Abfrage des Kenn- Assembler 
der Verbindung, von zeichens CID 
welcher der Partner- und (NAMXLATE) 
Prozessornamen bekannt 
ist? 
- Wie lautet der Partner- Abfrage des Partner- Assembler 


und Prozessornamens 
(CIDXLATE) 


und Prozessornamen von 
einer Verbindung, deren 
Kennzeichen bekannt ist? 


Tabelle 3-6 Möglichkeiten der Abfrage 


Zurückweisen einer Aufforderung zum Verbindungsaufbau 


Wie bereits beschrieben (siehe 3.2 und Bild 3-9), besteht die Möglichkeit, eine Aufforderung 
zum Aufbau einer Verbindung über die asynchrone LOGON-Meldung zu bekommen (siehe 
4.1.5). Ferner wurde erwähnt, daß die Information, wer die Aufforderung geschickt hat, samt 
einer evtl. übermittelten Verbindungsnachricht abgefragt werden kann (siehe unter 3.2 und 
3.2.2). Nach dem dies alles geschehen ist, kann nach Prüfung dieser Angaben die Entschei- 
dung fallen, daß mit dem auffordernden Partner keine Verbindung aufgebaut werden soll. In 
diesem Fall ist es möglich, die Aufforderung zurückzuweisen. Dafür gibt es den Aufruf 
YREJLOG. 


Es genügt, die mit YINQUIRE ermittelte Adresse des Partners (Partner- und Prozessorname) 
anzugeben. 
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3.2.4 Andern der Eigenschaften einer Verbindung 


Nachdem beim Aufbau einer Verbindung Ihre Eigenschaften festgelegt wurden, hat der 
Benutzer später noch die Möglichkeit Eigenschaften zu ändern. 


Geändert werden können Eigenschaften, die nur den Ändernden selbst betreffen, also nicht 
solche, die mit dem Partner abgestimmt werden müssen. 


Bei Abgabe des Aufrufs YCHANGE sind alle Werte, die im folgenden aufgezählt werden, 
einzustellen. Dabei ist es gleich, ob es geänderte (neue) Werte sind oder die bereits früher 
(alte) eingestellten. 


Es können geändert werden: 

Begleitinformation 

Behandlung zu langer Nachrichten 

Code der Nachrichten 

Werte für EDITIN (Nachrichtenbehandlung bei Eingabe) 
Werte für EDITOUT (Nachrichtenbehandlung bei Ausgabe) 


ggf. Adresse der Verteilcode-Beschreibung, zur Änderung der in Gruppen beschriebenen 
Verteilcodes (Lage und Länge in der Nachricht sowie Codeanzeiger können nicht geändert 
werden). 


Die Erläuterung dieser Angaben wurde im Abschnitt ‘Beschreibung der aufzubauenden 
Verbindung’ gegeben (siehe 3.2.1.1). 


3.2.5 Rücknahme einer Aufforderung 


Soll eine Aufforderung zum Verbindungsaufbau, die an einen Partner gerichtet wurde, wieder 
zurückgenommen werden, kann dies mit dem Aufruf YCLSCON erfolgen. 


Die Aufforderung zum Verbindungsaufbau wird zurückgenommen, wenn der Aufbau noch 
nicht erfolgt ist. Im anderen Fall wird die Verbindung abgebaut. 


3.2.6 Abbau einer Verbindung 


Der explizite Abbau einer Verbindung wird ebenfalls mit dem Aufruf YCLSCON durchgeführt. 


Es besteht keine Verpflichtung dazu, da alle Verbindungen implizit abgebaut werden, sobald 
eine DCAM-Anwendung geschlossen wird. Noch nicht abgeholte Nachrichten gehen bei 
Verbindungsabbau verloren. Deshalb wird empfohlen, die letzte Nachricht vor Verbindungs- 
abbau mit Transportquittung abzusichern. 


Der explizite Abbau kann erforderlich sein: 
e für die zeitliche Begrenzung einer Verbindung 


e zur Regelung des Datendurchsatzes (Verbindungen können abgebaut werden, um ande- 
ren Verbindungen günstigere Durchsatzraten zu ermöglichen) 


@ um eine Datenstation für eine andere Verbindung freizumachen, usw. 


DCAM V8.0A DCAM Programmschnittstellen, U1786-J-275-1 3-23 


3.3 


3.3.1 


Datenübermittlungsfunktion 


Nachdem eine DCAM-Anwendung eröffnet und eine Verbindung aufgebaut wurde, sind die 
Voraussetzungen zur Datenübermittlung gegeben. 


Die Datenübermittlungsfunktion führt aus: 


Senden einer Nachricht (YSEND) 


Die einem Kommunikationspartner zu übermittelnde Nachricht wird in den Datenspeicher 
des Kommunikations-Zugriffssystems übertragen. 


Empfangen einer Nachricht (YRECEIVE) 


Die Nachricht eines Kommunikationspartners (irgendeines, eines bestimmten oder mit 
einem bestimmten Verteilcode) wird in den Datenspeicher des Benutzerprogramms 
eingetragen. 


Senden und Empfangen kombiniert (YSENDREC) 


Mit einem Aufruf werden die Daten für eine Nachricht in den Datenspeicher des Kommu- 
nikations-Zugriffssystems eingetragen und es werden die Daten einer Nachricht des 
gleichen Kommunikationspartners in den eigenen Datenspeicher übernommen. Damit ist . 
ein effektives Hilfsmittel für Dialogverarbeitung gegeben. 


Á 


Zurücknehmen von Empfangsaufrufen und Ändern des CS/CA-Zustands einer Verbin- 
dung (YRESET) 


Mit diesem Aufruf kann ein Prozeß entweder alle seine anstehenden YRECEIVE-Aufrufe 
einer bestimmten Anwendung oder einer bestimmten Verbindung zurücknehmen und den 
CS/CA-Zustand ändern. 


Zur Steuerung der Nachrichtenverteilung anhand von Verteilcodes stehen zur Verfügung: 


Zuordnung von Verteilungsnamen zur Verteilcodegruppen (YPERMIT) 


Der Primärprozeß ordnet dem Verteilungsnamen eines oder mehrerer Sekundärprozes- 
se(s) bestimmte Verteilcodes zu. 


Auflösung dieser Zuordnung (YFORBID) 


Eine getroffene Zuordnung wird vom Primärprozeß wieder rückgängig gemacht. 


Senden einer Nachricht 


Jeder Prozeß einer DCAM-Anwendung kann eine Nachricht senden (YSEND) und löst damit 
folgende Aktionen aus: 


Die Daten, die als Nachricht für einen Partner bestimmt sind, werden in den Datenspeicher 
des Kommunikations-Zugriffssystems übertragen. 


Das Zugriffssystem erhält den Auftrag, die Daten dem Partner zu übermitteln. 


Der Aufruf wird abgeschlossen, und das Zugriffssystem beginnt mit der Übermittlung. 


Mit der zu übermittelnden Nachricht erhält das Zugriffssystem vom Benutzer eine Reihe von 
Angaben. Diese werden ergänzt durch Angaben, die beim Aufbau der logischen Verbindung 
festgelegt wurden (siehe 3.2.1.1). 
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Tabelle 3-7 zeigt, welche Zusatzangaben unter bestimmten Voraussetzungen notwendig sind. 


Voraussetzung(en) 


Nach erfolgtem Verbindungsaufbau wur- 
de die maximale Lange von Nachrichten 
auf dieser Verbindung vom System 
bekanntgegeben. 


- Bei der Eröffnung der Anwendung 
wurde der Quittungsempfang ermög- 
licht (für den Primärprozeß = 
PRIMTASK oder den auffordernden 
Prozeß = REQTASK) 

- Es ist die Bearbeitung von Trans- 
portquittungen vorgesehen. 

- Dem YSEND-Aufruf soll unmittelbar 
ein YCLSCON- oder YCLOSE-Aufruf 
folgen, sodaß die Verbindung u.U. 
abgebaut wird, bevor die Daten 
übermittelt sind. Hier sollte in 
jedem Fall die Transportquittung 
abgewartet werden. 


Die auf dieser Verbindung ankommenden 
Nachrichten sollen im folgenden 

über die absenderspezifische Warte- 
schlange empfangen werden. 


Die auf dieser Verbindung ankommenden 
Nachrichten sollen im folgenden 

über die empfängerglobale Warte- 
schlange empfangen werden. 


Auf dieser Verbindung wurde keine 
Nachrichtenaufbereitung durch das 
System vorgesehen. 

Es wurde eingestellt: 

-— EDIT=USER: Der Benutzer stellt die 
Nachricht so bereit, wie sie der 
Kommunikationspartner verarbeiten 
kann. 

- EDIT=SYSTEM und EDITOUT=PHYS: Das 
System übernimmt die Blockung bei 
Geräten mit kleinem Eingabepuffer. 
Alles übrige stellt der Benutzer 
so bereit, wie es die Datenstation 
verarbeiten kann. 


Auf dieser Verbindung wurde Nach- 
richtenaufbereitung durch das System 
vorgesehen. 


Es ist eine besondere Situation ein- 
getreten (z.B. Rückstau auf der Ver- 
bindung), die durch eine entsprechen- 
de Rückmeldung bei einem abgewiesenen 
YSEND festgestellt wurde. Es soll 
darum der Partner zur sofortigen Aus- 
gabe von Empfangsaufrufen aufgefor- 
dert werden. 


Bei der Eröffnung der Verbindung 
wurde mit PROC=SIGNAL das GO-Signal 
fiir den Fall der Uberlastung der 
Verbindung angefordert. 


Tabelle 3-7 
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Festlegungen 


Im Rahmen der Maximallänge wird die 


Länge der zu sendenden Nachricht 
angegeben. 


Es wird 

- eine Laufnummer angegeben, damit 
bei Eintreffen der Transport- 
quittung diese der richtigen Nach- 
richt zugeordnet werden kann. 
(höchster Wert = 2047). 

- es wird eine positive Quittung 
angefordert (negative Quittungen 
werden automatisch erzeugt, wenn 
die Nachricht nicht zugestellt 
werden kann). 


Es wird die absenderspezifische 
Warteschlange eingestellt (CS-Zustand 
der Verbindung) . 


Es wird die empfängerglobale Warte- 
schlange eingestellt (CS-Zustand 
der Verbindung). 


Die Nachricht kann klassifiziert 
werden als: 

— ELEMENT 

- SUBGROUP 

- GROUP 

Diese Kennzeichnung der Nachricht 
wird durch das Netz zum Empfanger 
übertragen. Er erhält sie mit der 
Nachricht. Ist er eine Datenstation, 
wird ein ELEMENT als Teilnachricht, 
SUBGROUP und GROUP als Nachricht mit 
Abschluß der Übertragung über- 
mittelt. 


Für die Benutzung der Logischen 

Datenstationen gelten besondere 

Regeln 

(siehe auch Abschnitte 2.3.4 und 
3.2.1.1; ferner Bild 3-8). 


Die Nachricht wird als Expreßnach- 
richt deklariert, was allerdings 
beinhaltet, daß ihre Länge 
höchstens 8 Bytes betragen darf. 


Bei jedem YSEND-Aufruf ist ein 
gültiges Ereigniskennzeichen (EID) 
anzugeben, über welches ggf. ein 
GO-Signal zugestellt werden kann. 


Festlegungen beim Senden einer Nachricht 


Je nach Einstellung der Nachrichtenaufbereitung ist für den Aufbau der Nachrichten unter- 
schiedlich vorzugehen. 


e Bei Verwendung der Zeilen-Datenstation kann der Benutzer die Nachrichten in logische 
Zeilen unterteilen. Jede logische Zeile wird mit dem Zeichen ‘Neue Zeile’, sedezimal 15, 
abgeschlossen. Der darauf folgende Text wird an der Datenstation automatisch auf den 
Zeilenanfang der nächsten Zeile gesetzt. Ist eine logische Zeile länger als die Zeilenlänge 
der Datenstation, wird die logische Zeile automatisch weiter unterteilt. Der Beginn einer 
Nachricht wird immer auf den Zeilenanfang einer neuen Zeile gesetzt. In Bild 3-13 wird dies 
an einem Beispiel veranschaulicht. 


Nachricht an Zeilen-Datenstation 


1. Logische Zeile 


2. Logische Zeile 3. Logische Zeile USW. 


Abbildung, z.B. auf einem Bildschirm mit 54 Zeichen Zeilenlänge 


Bild 3-13 Nachricht an die Zeilen-Datenstation 


Zusätzliche verfügbare Funktionen sind: 


Funktion Steuerzeichen Wirkung 

— Neue Seite sedezimal 0C Seitenvorschub 

— Hervorheben Ein sedezimal 1D Ausgabe blinkend oder kursiv 

— Hervorheben Aus sedezimal 1E Ausgabe normal 

— Shift Aus sedezimal OE | Umschalten auf zweiten Zeichenvorrat 
— Shift Ein sedezimal OF Umschalten auf Standardzeichenvorrat. 


e Wird die Format-Datenstation eingesetzt, übergibt der Benutzer die Nachricht so, wie er 
sie von der Formatierungsroutine bekommt, jedoch ohne das vorgesetzte Satzlängenfeld. 
Die Satzlänge muß er aus dem Satzlängenfeld in das entsprechende DCAM-Feld übertra- 
gen. 
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e Wurden für die Verbindung die Werte EDIT = SYSTEM und EDITOUT= PHYS eingestellt, 
muß jeder Nachricht ein sog. Kopflängenbyte vorangestellt werden. Die dort enthaltene 
Binärzahl gibt an, wie lange der darauf folgende Nachrichtenkopf einschließlich dieses 
Bytes ist. Der Nachrichtenkopf wird der Datenstation, im Unterschied zur eigentlichen 
Nachricht, ohne Codeübersetzung übermittelt. Der Benutzer kann sich bei der Erstellung 
und auch späteren Auswertung des Nachrichtenkopfes somit an die Gerätebeschreibung 
halten. Bei Geräten, die keinen Nachrichtenkopf verarbeiten, muß dennoch das Kopflän- 
genbyte vor die Nachricht gesetzt werden, in diesem Fall mit der Länge 1. 


Im Bild 3-14 wird im Überblick gezeigt, wie die Nachrichten aufzubauen sind. 


Länge in KL 


Ve eS a 


Nachrichtenlänge 
KL = Kopflängenbyte enthält binäre Länge vonKL + NK 


f 
NK = Nachrichtenkopf variabler Länge je nach Gerätefunktion 
im Gerätecode; entfällt bei Geräten, die anders gesteuert werden. 


Bild 3-14 | Aufbau der Nachricht bei EDITOUT = PHYS 


Die Nachricht kann in diesem Fall und wenn EDIT = USER eingestellt wurde, in Teilnachrichten 
unterteilt werden (Bild 3-15). Jede Teilnachricht muß entsprechend markiert werden. 


Nachricht 5 


Nachricht 2 | Nachricht3 | Nachricht4 | 
ELEMENT | ELEMENT | ELEMENT | SUBGROUP 


Bild 3-15 Beispiel fur Strukturierung von Nachrichten 


Nachricht 1 Nachricht 7 


ELEMENT 


Abhängig vom Gerätetyp und -zustand ist mit einem unterschiedlichen Verhalten der Geräte 
zu rechnen (siehe Zugriff zu Datenstationen). 


Anmerkung: 


Nach der Übertragung von Teilnachrichten werden mehrfach genutzte physikalische Leitun- 
gen (Konzentrator) jeweils wieder freigegeben. 
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3.3.2 Empfangen einer Nachricht oder Transportquittung 9 


Empfangen einer Nachricht bedeutet, daß die Nachricht eines Partners in den Datenspeicher 
des eigenen Programms übertragen wird, nachdem sie aus der Warteschlange ausgetragen 
wurde. 


Dieser Vorgang ist mit Beendigung des Aufrufs abgeschlossen, wenn dieser synchron 
ausgeführt wurde. Wenn er aber asynchron ausgeführt wurde, ist mit Abschluß des Aufrufs 
lediglich der Befehl an das Kommunikationssystem gegeben, die Nachricht, wenn sie eintrifft, 
zu übertragen. Der Benutzer erhält auf ein vereinbartes Ereigniskennzeichen ein Signal, wenn 
die Nachricht übertragen ist. Er kann dieses Signal abfragen und danach die Nachricht 
verarbeiten (siehe auch 4.1.3). 


Bei dieser Methode wird die evtl. unvermeidliche Wartezeit auf eine Nachricht für eine andere 
Verarbeitung genutzt. Welche Nachrichten ein Prozeß empfangen kann, ist abhängig von der 
Art der Anwendung, der verwendeten Nachrichtenverteilung und der eingestellten Warte- 
schlange, ferner davon, ob es sich um eine Normal- oder Expreßnachricht handelt (siehe dazu 
Tabelle 3-8). 


Nach ihren Verteilcode 

wird sie dem Prozeß Sie wird dem 
übergeben, der zum Primärprozeß übergeben 
Empfang berechtigt P ` 

ist. ') 


Sie wird dem ProzeB 
übergeben, der zuerst 
auf die empfänger- 
globale Warteschlange 
(ANY) zugreift 


Sie wird dem 
Primärprozeß übergeben 


Sie wird dem Prozeß übergeben, der 

die absenderspezifische Warteschlange einge- 

stellt hat (den CS-Zustand verursacht 9 
hat). 


1) Ist der Verteilcode noch nicht vorgesehen oder keinem 
Sekundärprozeß zugeordnet, wird die Nachricht 
dem Primärprozeß zugestellt. 


Tabelle 3-8 Nachrichtenverteilung und -empfang 
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. 


Bei Abgabe des YRECEIVE-Aufrufs macht der Benutzer zusätzlich zur Beschreibung der 
Verbindung, die bereits mit YOPNCON festgelegt wurde (siehe 3.2.1.1) weitere Angaben: 


e zur Nachricht: 


Er legt die Adresse des Feldes fest, in das die Nachricht eingetragen werden soll mit der 
Länge, die durch dieses Feld vorgegeben ist. 


Er kann die Behandlung zu langer Nachrichten, wie sie beim Verbindungsaufbau festge- 
legt wurde, dieser Nachricht angepaßt ändern. Er kann also für diesen Aufruf festlegen, ob 
eine Überlänge für weitere Abholung aufgehoben oder ob sie weggeworfen werden soll. 


e Zur Ausführung des Aufrufs: 


Hier sind voneinander abhängige Angaben zu machen, wie sie in Bild 3-16 dargestellt sind. 


2) Empfangen der Nachricht h 


Für die weitere Nachrichtenverteilung wird 
die empfängerglobale (CA) oder absender- 
spezifische (CS) Warteschlange eingestellt 


3 


Does ees mme ame ares mae ene wees ay 


1) Angaben nur möglich, wenn Nachrichtenverteilung ohne Verteilcodes 
?) Bei Nachrichtenverteilung mit Verteilcodes ist dazu keine Einstellung von CS nötig 
3) Der Aufruf kann vor erfolgtem Aufbau einer Verbindung abgegeben werden. 
Er wird allerdings erst ausgeführt, wenn mindestens eine Verbindung 
aufgebaut wurde. 
4) weitere Angaben siehe Abschnitt 4.1.3 
5) wahlweise; wenn nicht angegeben, wird der Aufruf sofort beendet, auch 
wenn er nicht ausgeführt werden kann 


Bild 3-16 Angaben zum Empfang einer Nachricht 
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Nach erfolgtem Nachrichtenempfang im angegebenen Bereich werden von DCAM weitere =) 
Informationen zurückgegeben: 


e Absenderangabe, 


wenn von einem beliebigen Partner empfangen wurde (ANY). 


e Laufnummer der Nachricht, 


wie vom Partner festgelegt oder eine im System erzeugte (bei Datenstationen als 
Absender). 


e Begleitinformation des Benutzers, 


wie er sie beim Aufbau der Verbindung festgelegt hat (Empfang von einem beliebigen 
Partner: ANY). 


e Struktur der Nachricht (Angaben im Rückmeldefeld) und zwar, ob es ein Element, das 
letzte Element einer Untergruppe oder einer Gruppe ist (siehe auch Bild 3-14). 


@ Typ der Nachricht (Angaben im Rückmeldefeld) und zwar, ob eine Normal- oder Expreß- 9 
nachricht übermittelt wurde. 


e Länge der Nachricht oder, wenn die Nachricht länger als der zur Verfügung gestellte 
Speicherbereich ist, die Länge des zu langen, noch nicht übermittelten Teils (KEEP). Soll 
auf den zu langen Teil mit einem weiteren Empfangsaufruf zugegriffen werden, muß 
vorher die absenderspezifische Warteschlange eingestellt worden sein. 


Die Möglichkeit, Transportquittungen zu empfangen, ist abhängig von Festlegungen bei der 
Eröffnung der Anwendung und Angaben beim Senden der Nachricht, um deren Quittung es 
geht (siehe dazu Tabelle 3-9). 


Eine positive Quittung wird Es wird keine positive Quittung 
angefordert (TACK) angefordert (NTACK) 


Der anfordernde Auslieferung von positiven Auslieferung nur von 
Prozeß soll Quittungen und negativen Quittungen negativen Quittungen J 
erhalten an den anfordernden an den PrimarprozeB 

(REQTASK) Prozeß 


Auslieferung von positiven und 
 Quittungen an den Primärprozeß 


Es sollen keine 

Quittungen über- Es werden weder positive noch negative Quittungen übergeben 
geben werden 

(NOTACK) 


Tabelle 3-9 Auslieferung von Transportquittungen 
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Soweit nicht die Ubergabe mit asynchroner Meldung vereinbart wurde (siehe Abschnitt 4.1.5), 
werden Transportquittungen mit einem YRECEIVE-Aufruf empfangen. Alle Angaben Uber die 
Art der Quittung usw. werden im Rückmeldefeld des Aufrufs übergeben. Ferner steht im Feld 
“TACKNO’ die Laufnummer der Nachricht, wie sie beim Senden festgelegt wurde. Damit ist 
eine Identifikation möglich. 


Zu beachten ist, daß der Empfang einer Transportquittung mit YRECEIVE keine Auswirkung 
auf die Einstellung der Warteschlange hat (CS-/CA-Zustand), auch wenn dies im Aufruf 
angegeben war. 


Einschränkung: 


Auf YSEND kann bei EDIT=SYSTEM eine zweite, negative Transportquittung eintreffen. Sie 
geht bei SHARE-Anwendungen unabhängig von REOTASK an den Primärprozeß. (Diese 
Einschränkung gilt bis einschließlich DCAM V8.0). 


3.3.3 Senden und Empfangen kombiniert 


Wenn der kombinierte Aufruf verwendet werden soll, gilt das, was bereits zu den einzelnen 
Aufrufen gesagt wurde. Da die Kombination nur den Zugriff auf die absenderspezifische 
Warteschlange zuläßt, muß für diese Verbindung die absenderspezifische Warteschlange 
eingestellt worden sein (=CS-Zustand der Verbindung); beim YOPNCON oder bei einem 
früheren YSEND, YSENDREC oder YRECEIVE. 


Einschränkung: 


Bei COBOL gibt es YSENDREC nicht. 


3.3.4 Zurücknehmen von Empfangsaufrufen und Ändern des CS/CA-Zustands 


Mit diesem Aufruf können asynchrone YRECEIVE-Aufrufe zurückgenommen werden. 
Ein YRESET(ANY)-Aufruf nimmt alle YRECEIVE-Aufrufe beliebiger Partner (ANY) zurück. 


Ein YRESET(SPEC)-Aufruf nimmt alle YRECEIVE-Aufrufe eines bestimmten Partners (SPEC) 
zurück. 


Bei Anwendungen mit ATTR=NSHARE oder (SHARE, NDISCO) setzt ein YRESET(SPEC) 
gleichzeitig den CS/CA-Zustand neu. 
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3.3.5 


Steuerung der Verteilcode-Zuordnung 


Der Primärprozeß steuert die Verteilcode-Zuordnung, indem er eine Verteilcode- Gruppe 
einem Verteilungsnamen zuordnet oder die Zuordnung wieder auflöst. Dies ist eine von drei 
Maßnahmen, die in beliebiger Abfolge zu treffen sind: 


Die Verteilcode-Gruppe definiert der Primärprozeß für eine oder mehrere Verbindungen, 
wenn er die Verbindungen aufbaut (siehe 3.2.1.4). 


Den Verteilungsnamen gibt/geben ein oder mehrere Prozess(e) beim Eröffnen der Anwen- 
dung an (siehe 3.1.1.3 und 3.1.1.5). 


Zugeordnet wird somit vom Primärprozeß den Codes einer oder mehrerer Verbindungen der 
Verteilungsnamen einer oder mehrerer Prozesse. 


Löst der Primärprozeß eine solche Zuordnung auf, verhindert er die Datenübermittlung von 
den betroffenen Verbindungen zu den betroffenen Prozessen. 


DCAM-Anwendung 


Zuordnung her- 
gestellt durch: 


YOPEN => 
VERT #0 Verteilungs- 
| namen 
YPERMIT — 
Verteilcode- 
Gruppen 
YOPNCON — 
(YCHANGE) 


Lage = 20 
Länge =5 


Lage=5 Lage=6 
Länge = 1 Länge = 1 


Lage = g Lage = Lage = a 
Länge = gaie = Länge = 
YOPNCON == 


Logische Verbindungen 


= = Standard (ohne Zuordnung) 


Bild 3-17 Gesamtübersicht der Nachrichtenverteilung anhand von Verteilcodes (Beispiel) 
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3.3.5.1 


3.3.5.2 


Zuordnen eines Verteilungsnamens zu einer Verteilcode-Gruppe 


Mit dem Aufruf YPERMIT erfolgt die Zuordnung eines Verteilungsnamens zu einer Verteilco- 
de-Gruppe. Nun können Prozesse, die diesen Namen angegeben haben, Nachrichten mit den 
Codes der zugeordneten Gruppe erhalten. 


Für die Zuordnung gilt: 


e Eine Gruppe von Verteilcodes (Beschreibung der Stufe 2) kann immer nur einem Vertei- 
lungsnamen zugeordnet werden. 


e Bis zu 8 Prozesse können den gleichen Verteilungsnamen benutzen. Dies ist dann 
notwendig, wenn ein Programm (SHARED CODE, siehe 4.1.6 und 4.2.4) mehrere Prozesse 
steuert. Bei gleichem Verteilungsnamen werden die Prozesse nach dem ’fifo’-Prinzip 
bedient (fifo=first in first out: Der Warteschlangeneintrag, der zuerst erfolgte, wird auch 
zuerst bearbeitet.) (siehe auch Bild 3-18). 


@ Im Rahmen der getroffenen Zuordnung kann ein Prozeß ferner absenderspezifisch auf die 
Nachrichten zugreifen (YRECEIVE SPEC). Dazu ist nicht notwendig, diese Warteschlange 
vorher einzustellen (Es gibt keinen CS/CA-Zustand der Verbindung, wenn mit Verteilcodes 
gearbeitet wird). 


Kommunikations- 
partner B 
(DCAM-Anwendung, 
mehrfach benutz- 
bar, Nachrichtenver- 
teilung anhand von 
Verteilcodes) 


maximal 16 Warteschlangen 
(Assembler) 
bzw. 8 (COBOL) - eine 
je Codegruppe 


mit} maximal 


Kommunikations- 
partner A 

(DCAM-Anwendung 
oder Datenstation) 


*) Zuordnung der Warteschlangen (Codegruppen) **) max. 8 Prozesse je Verteilungsname 
zu den Verteilungsnamen erfolgt mit eigenen : 
Aufrufen der Datenübermittlungsfunktion 


Bild 3-18 Beispiel fur Adressierung einer Prozeßgruppe über Verteilcodes 


Nachrichten mit Verteilcodes, die keinem Verteilungsnamen zugeordnet wurden oder die 
nicht interpretierbar sind, werden dem Primärprozeß zugeleitet. 


Alte Zuordnungen können durch neue ersetzt werden, wenn ein neuer YPERMIT-Aufruf 
gegeben wird. 


Auflösen der Zuordnung 


Soll die Zuordnung für einen Verteilungsnamen aber nicht neu getroffen, sondern nur 
rückgängig gemacht (aufgelöst) werden, steht dafür der YFORBID-Aufruf zur Verfügung. 
Bereits eingetroffene Daten werden danach dem Primärprozeß übergeben. 
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3.4 


Namen-Zuweisungsfunktion 


Diese Funktion erlaubt es, Parameterwerte für die DCAM-Anwendung oder die logischen 
Verbindungen erst zum Ablaufzeitpunkt anzugeben. Dies wird erreicht durch Verknupfung 
gültiger Werte in einer prozeßspezifischen Tabelle (CLT = communication link table) mit den 
Angaben im Programm (zum Vergleich: Die Aktualisierung der Einträge im FCB (file control 
block) eines Programms erfolgt durch die TFT (task file table), deren Einträge durch den 
FILE-Makro, bzw. das /FILE-Kommando erzeugt wurden). 


Im Bild 3-19 wird ein Beispiel gezeigt (ACB-Steuerblock siehe 4.1.1; A-Struktur siehe 4.2.1) 


Kommandomodus: 


APPLICATION ANWEND 4, LINK = KETT 4 


IEXEC sirt 6 0 
Programmodus: 


YOPEN 


Die Eröffnung der 
DCAM-Anwendung 

beginnt mit der Über- 

nahme der gültigen Werte 

aus der CLT und dem ACB- 
Steuerblock, bzw. der A-Struktur: 


Bild 3-19 Beispiel für Zuweisung des Namens einer DCAM-Anwendung 
Die Tabelle wird aufgebaut: 
e im Programmodus (nur Assembler) durch die Makros 
YAPPL für Angaben zur Anwendung und 
YCONN für Angaben zur Verbindung 
e im Kommandomodus (Assembler/COBOL) durch die Kommandos 
/APPLICATION für Angaben zur Anwendung und 
/CONNECTION für Angaben zur Verbindung (siehe Kommandosprache). 
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Die Verknüpfung wird hergestellt durch die Angabe eines Kettungsnamens sowohl im 
Programm als auch in der CLT. Folgende Werte können in dieser Weise aktualisiert werden: 


e Füreine DCAM-Anwendung: 
— der Name der DCAM-Anwendung; 
— der Verteilungsname; 


— das Kennwort für den Anschluß eines Sekundärprozesses an eine Anwendung, vorge- 
geben im Primärprozeß; 


— das Kennwort für den Anschluß eines Sekundärprozesses an eine Anwendung, ange- 
geben im Sekundärprozeß; 


— das Kennwort zum Aufbau einer Verbindung, vorgegeben im Primärprozeß; 


e für die logische Verbindung: 
— der Name des Partners; 
— der Name des Prozessorknotens, an dem der Partner als Station angeschlossen ist; 
— die Begleitinformation; 


— das Kennwort zum Aufbau einer Verbindung, angegeben von dem Prozeß, der die 
Aufforderung dazu abgibt. 


Bei der Ausführung von YOPEN, bzw. des YOPNCON-Aufrufs werden die Angaben in 
Steuerblöcke oder Datenstrukturen von DCAM übernommen. Sie werden, soweit Einträge in 
der CLT vorliegen, um diese Werte aktualisiert. Wurden keine Einträge gemacht, bleiben sie 
unverändert. Danach ist eine dynamische Namen-Zuweisung für diese Anwendung oder 
logische Verbindung erst möglich, wenn sie wieder geschlossen wurde (außer Änderung der 
Begleitinformation mit YCHANGE, siehe 3.2.4). 


Sollen Einträge in der CLT gelöscht werden, genügt es, die Makros YAPPL bzw. YCONN oder 
die entsprechenden Kommandos nur mit dem Kettungsnamen zu geben. 
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4.1 


Codierung und Ausführung von 
DCAM-Programmen 


In diesem Kapitel wird nicht etwa die genaue Anleitung zur Codierung gegeben. Dafür stehen 
eigene Manuale zur Verfügung (siehe DCAM Makroaufrufe und DCAM COBOL-Aufrufe). 


Vielmehr sollen die sprachspezifischen Eigenheiten der DCAM-Schnittstelle gezeigt werden. 


Zwei Sprachen kann der DCAM-Programmierer benutzen: 


e Assembler 
e COBOL 


Nach dem Überblick über die Verwendung von DCAM in diesen Sprachen werden die Fragen 
beantwortet: 


e Wie wird ein DCAM-Programm gestartet? 


e Wie wird ein DCAM-Programm beendet? 


Erstellung eines Assembler-Programms 


Die Assembler-Programmschnittstelle bietet den vollen Umfang aller DCAM-Funktionen, wie 
sie bereits (Kapitel 3) detailliert beschrieben wurden. 


In diesem Abschnitt soll ein Überblick über die spezifischen Merkmale der Schnittstelle 
gegeben werden. 


Makroaufrufe und Steuerblöcke 


Alle DCAM-Funktionen werden durch Makroaufrufe ausgelöst. Die Aktionsmakros beziehen 
sich dabei jeweils auf Steuerblöcke, in denen alle Parameter hinterlegt werden. Es werden 
zwei Gruppen von Aufrufen unterschieden, je nach dem Typ des Steuerblocks, auf den sie 
sich beziehen: 


e Makroaufrufe, die sich auf einen ACB (application control block) = Anwendungssteuer- 
block beziehen. 


e Makroaufrufe, die sich auf einen RPB (request parameter block) = Anforderungspara- 
meter-Block beziehen. 


Auf einen ACB, der alle Informationen über die DCAM-Anwendung enthält, beziehen sich: 
— YOPEN (Eréffnen einer DCAM-Anwendung) 
— YCLOSE (Schließen einer DCAM-Anwendung). 


Sollen asynchrone DCAM-Meldungen verarbeitet werden, wird zusätzlich ein ENB (event 
notification block) = Ereignis-Meldungsblock benötigt. In ihm werden die Kennzeichen für 
die Contingency-Routine hinterlegt (siehe auch Abschnitt 4.1.5). 


Eine Übersicht gibt Bild 4-1. 


DCAM V8.0A DCAM Programmschnittstellen, U1786-J-Z75-1 4-1 


Bild 4-1 ACB-bezogene Makroaufrufe 


Auf einen RPB, der jeweils die aktuellen Parameterwerte der Aktionsaufrufe enthalt, beziehen 
sich: 


— YSETLOG (Andern des Zustands einer DCAM-Anwendung) 


— YINQUIRE (Abfragen von Eintragungen über DCAM-Anwendungen, Partner und Verbin- 
dungen) 


— YOPNCON (Aufbau einer Verbindung) 

— YCLSCON (Abbau einer Verbindung) 

— YREJLOG (Zurückweisen einer Aufforderung zum Verbindungsaufbau) 

— YCHANGE (Ändern der Eigenschaften einer Verbindung) 

— YSEND (Senden einer Nachricht) 

— YRECEIVE (Empfang einer Nachricht) 

— YSENDREC (Senden einer Nachricht mit Empfang einer neuen Nachricht) 

— YRESET (Zurücknehmen von Empfangsaufrufen und Ändern des CS/CA-Zustands) 
— YPERMIT (Empfang mit Verteilcode ermöglichen) 

— YFORBID (Empfang mit Verteilcode verbieten). 


Zusätzlich zum RPB werden für verschiedene Aufrufe noch weitere Steuer- 
blöcke benötigt: 


Die Operanden für eine Verbindung stehen im 
CCB (connection control block) = Verbindungssteuerblock, 


Lage und Länge des Verteilcodes, Codeanzeiger und die Verweise auf 
zugeordnete Verteilcodegruppen stehen im 
DIP (distribution parameter block) = Verteilungsparameter-Block 


und die Verteilcodes selbst werden im 

DCG (distribution code group block) = Verteilcode-Gruppenblock 
beschrieben. 

Eine Übersicht gibt Bild 4-2. 


Hinweis: 


DCAM-Anwender, die über eine X.25-Schnittstelle an ein Paketvermittlungsnetz (z.B. Datex-P) 
angeschlossen sind, müssen bestimmte Einschränkungen bei den Aufrufen, die sich auf 
Verbindungen oder auf die Datenübermittlung beziehen, berücksichtigen. Sie sind im Manual 
‘DCAM Makroaufrufe’ (Anhang A.11) beschrieben. 
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Bild 4-2 RPB-bezogene Makroaufrufe 


Der Programmierer braucht den internen Aufbau der Steuerblöcke nicht zu kennen, denn es 
stehen ihm Makroaufrufe zur Erzeugung und zur Behandlung von Steuerblöcken zur Verfü- 


gung. 
Zur statischen Steuerblockerzeugung gibt es die Makroaufrufe 
— YACB Erzeugen ACB 
— YENB (Erzeugen ENB) 
— YRPB (Erzeugen RPB) 
— YCCB (Erzeugen CCB) 
— YDIP (Erzeugen DIP) 
— YDCG Erzeugen DCG) 


In diesem Fall werden Steuerblöcke bei der Assemblierung erzeugt. 
Hinweis: 


Spätere Änderungen im Layout der Blöcke durch den Hersteller kann eine Neuassemblierung 
erforderlich machen. 
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Die Steuerblöcke können auch direkt durch den Benutzer mit den Makroaufrufen 
YDDACB 

YDDCCB 

YDDDCG 

YDDDIP 

YDDENB 

YDDRPB 


erzeugt und behandelt werden. Diese Makroaufrufe beschreiben das Layout (DSECT und 
CSECT) der Steuerblöcke. 


Hinweis: 


Bei diesen Makroaufrufen ist keine Source-Kompatibilität gewährleistet, da das Layout der 
Steuerblöcke geändert wird, wenn neue Versionen dies erfordern. 


Zur dynamischen Erzeugung eines Steuerblocks während des Programmablaufs im Spei- 
cherbereich des Benutzers (Klasse-6-Speicher) oder wahlweise in einem Bereich außerhalb 
des Benutzerprogramms (Klasse-5-Speicher) steht der Makroaufruf 


— YGENCB (Erzeugen Steuerblock) zur Verfügung. 


Damit wird ein Programm von jeder Änderung unabhängig. Es ist daher diese Methode zu 
empfehlen. 


Für die Behandlung der Steuerblöcke gibt es die Aufrufe 
— YMODCB (Verändern des Inhalts von Steuerblockfeldern), 


— YSHOWCB (Ubertragen von Inhalten bezeichneter Steuerblockfelder in einen im 
Programm reservierten Bereich), 


— YTESTCB (Vergleichen von Steuerblockfeldinhalten mit vorgegebenen Werten). 


Der RPB kann auch mit jedem Makroaufruf, der ihn adressiert, geändert werden (implizite 
RPB-Modifikation). Es bleibt dem Benutzer überlassen, ob er mehrere RPB-Steuerblöcke 
anlegt oder jeweils denselben adressiert, wobei er die Feldinhalte aktualisiert. 


Mit dem Aufruf YOPEN werden die im ACB beschriebenen Eigenschaften der Anwendung an 
DCAM übergeben. Nach Ausführung des YOPEN gibt DCAM dafür im ACB ein Kennzeichen 
zurück, den AID (application identifier). Alle Aufrufe, die sich auf diese Anwendung beziehen, 
können nun die Adresse des Steuerblocks ACB verwenden, in dem das gültige Kennzeichen 
steht (siehe Bild 4-3). | 


*) wurde bei Ausführung 
des YOPEN bzw. YOPNCON 
von DCAM eingetragen. 


Bild 4-3 Beispiel für Adressierung von Steuerblöcken ohne Verwendung der Kennzeichen 
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Es ist aber auch möglich, das Kennzeichen AID sicherzustellen und in den für weitere Aufrufe 
verwendeten RPB einzusetzen (Bild 4-4). 


*) Das Kennzeichen wurde nach YOPEN bzw. 
YOPNCON sichergestellt und mit 
YMODCB in den RPB eingetragen 


**) Das Kennzeichen wurde nach YOPNCON bzw. 
YRECEIVE ANY hier eingetragen, falls dieser 
RPB dafür verwendet wurde. 


Bild 4-4 Beispiel für Adressierung eines RPB, in den gültige Kennzeichen eingetragen 
wurden. 


In diesem Fall kann der Speicherbereich für den ACB anderweitig genutzt werden. Das gleiche 
gilt für die Beschreibung der Verbindung im CCB, bzw. DIP und DCG. Auch nach einem 
YOPNCON kann z.B. das Kennzeichen CID (connection identifier), das im CCB und RPB 
zurückgegeben wird, benutzt werden. YSEND und YRECEIVE bzw. YSENDREC benötigen nur 
noch Steuerblöcke RPB, in denen entsprechende Kennzeichen AID und CID eingetragen 
wurden. Wenn der Eintrag nicht schon durch DCAM erfolgte, kann er jederzeit mit YMODCB 
erfolgen, vorausgesetzt, das Kennzeichen wurde vorher mit YSHOWCB sichergestellt. 


Die Verwendung der Kennzeichen hat den Vorteil, daß DCAM alle für den Aufruf nötige 
Information im RPB findet. Damit wird die Verarbeitung beschleunigt. 


Synchrone Ausführung der Befehle an DCAM 


Wurde ein Aufruf an DCAM mit dem Parameter gerichtet, daß der enthaltene Befehl synchron 
ausgeführt werden soll, so wird das Programm erst dann wieder über die Prozeßverwaltung 
die Steuerung erhalten können, wenn dieser Aufruf von DCAM bearbeitet worden ist. Dies ist 
problemlos, wenn DCAM in der Lage ist, den Aufruf sofort zu bearbeiten. Bei einigen 
Funktionen kann es allerdings sein, daß Wartezeiten entstehen, da auf eine korrespondie- 
rende Reaktion des Kommunikationspartners gewartet werden muß. Bei dem Aufbau einer 
logischen Verbindung (YOPNCON) muß der Kommunikationspartner seinerseits die Verbin- 
dung aufgebaut haben, und beim Empfang von Nachrichten (YRECEIVE) muß der Partner 
diese vorher gesendet haben. Sie müssen im Datenspeicher des Kommunikationssystems zur 
Verfügung stehen und in einer Warteschlange eingetragen sein. 


Der Programmierer hat die Möglichkeit zu entscheiden, ob er bereit ist, eine bestimmte Zeit zu 
warten bis der Aufruf ausgeführt werden kann. Er legt die maximale Wartezeit für jeden Aufruf 
fest. Er kann aber auch festlegen, daß überhaupt nicht gewartet werden soll. Ein solcher 
Aufruf wird sofort beendet, auch wenn der Befehl nicht ausgeführt werden kann. Im 
Programm muß der Aufruf dann zu einem anderen Zeitpunkt ggf. wiederholt werden (siehe 
auch Bild 4-5). 
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4.1.3 


Benutzer-ProzeB System 


Beispiel 1 


Wartezeit 


weitere Verarbeitung 


Beispiel 2 


Wartezeit 


weitere Verarbeitung 


muß mit 
einem 
weiteren 
YRECEIVE 
abgeholt 
werden 


Bild 4-5 Beispiele fur synchrone Ausführung des YRECEIVE 


Asynchrone Ausführung der Befehle an DCAM 


Der Aufbau einer Verbindung und der Empfang von Nachrichten kann, wie schon im vorigen 
Abschnitt erwähnt, zu Wartezeiten führen. Um den Datendurchsatz zu erhöhen, insbeson- 
dere, wenn sehr viele Partner bedient werden sollen, können diese Wartezeiten für anderwei- 
tige Verarbeitung genutzt werden. Zu diesem Zweck definiert der Benutzer ein Ereignis 
(Makroaufruf ENAEI) und gibt dessen Kennzeichen EID bei dem Aufruf YOPNCON, YRECEIVE 
oder YSENDREC, dessen Befehl asynchron bearbeitet werden soll, an. Nach Beendigung des 
Aufrufs und Annahme des Befehls durch DCAM erhält er sofort die Steuerung zurück. Das 
Ereignis ist z.B. die Nachrichtenübergabe. Er kann dieses Ereignis an der Stelle im Programm 
abfragen (Makroaufruf SOLSIG, an der er z.B. die Nachricht verarbeiten möchte (siehe Bild 
4-6). 
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Benutzer-ProzeB System 


ENAEI: Ereignis definieren 


Ubergabe des Ereigniskennzeichens 


weitere Verarbeitung 


die Wartezeit auf das Eintref- 
fen der Nachricht wird durch 
weitere Verarbeitung genutzt 


Verarbeitung der 
Nachricht 


Beispiel 2 ENAEI: Ereignis definieren 


Ubergabe des Ereigniskennzeichens 


$ weitere Verarbeitung 


die Wartezeit auf das Eintreffen der 
Nachricht wird durch weitere Ver- 
arbeitung genutzt 


Wartezeit ET 
Nachricht 


Verarbeitung der 
Nachricht 


a Winn 


Zeit 


EID = Kennzeichen fiir das Ereignis (hier Eintreffen der Nachricht) 
wird als Bezugspunkt fiir Ubergabe und Ubernahme der Nachricht 
verwendet 
*) Fur YRECEIVE und SOLSIG wird jeweils eine maximale Lebensdauer festgelegt 
(hier nicht gezeigt) 


Bild 4-6 Beispiele für asynchrone Ausführung des YRECEIVE 


Dort kann er ggf. eine bestimmte Zeit warten, falls z.B. die Nachricht noch nicht eingetroffen 
ist. 


Er kann aber auch mit dem Ereignis eine Contingency-Routine verbinden. In diesem Fall wird 
er das Ereignis zweckmäßigerweise abfragen, sobald er den Aufruf an DCAM abgesetzt hat. Er 
kann es jederzeit, sobald er die Contingency-Routine definiert und ihr Kennzeichen COID zur 
Verfügung hat (Makroaufruf ENACO). 


Trifft das Ereignis ein, so wird automatisch die Routine gestartet (siehe Bild 4-7). 
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a | System 


ee ae | 
ENAEI: Ereignis definieren 
(m) Übergabe des Ereigniskennzeichens SN 


ENACO: Contingency definieren 


Übergabe des Contingency- 
Kennzeichens 


: 
| 
i 
i 

J 


° weitere Verarbeitung 


EID = Kennzeichen für das Ereignis (hier Eintreffen einer 
Nachricht), wird als Bezugspunkt für Übergabe und Übernahme 
der Nachricht verwendet. 
COID = Kennzeichen der Contingency-Routine 
*) Für YRECEIVE und SOLSIG wird jeweils eine maximale 
Lebensdauer festgelegt (hier nicht gezeigt) 
**) Die Wartezeit auf das Eintreffen der Nachricht wird durch 
weitere Verarbeitung genutzt. 


Bild 4-7 Beispiel mit Contingency-Routine 


Zu beachten ist, daß für die einzelnen Aufrufe eine maximale Lebensdauer zu definieren ist, 
die aufeinander abgestimmt sein muß. Die Lebensdauer des SOLSIG sollte größer sein als die 
des Befehls an DCAM. Sonst muß der SOLSIG ggf. wiederholt gegeben werden. 


Es sollte verhindert werden, daß im Programm bereits Maßnahmen getroffen werden, die von 
einem Abschluß der asynchronen Verarbeitung ausgehen, ohne daß diese jedoch erfolgt ist 
(ein Abbau der Verbindung z.B. bei asynchroner Verarbeitung eines YRECEIVE). 


Einschränkung: 


Maximal können 8 Befehle eines Typs gleichzeitig asynchron bearbeitet werden (siehe 
Anhang A.2). 


Um bei asynchronen Befehlen auch nach Eintreffen des Ereignisses noch auf Werte zurück- 
greifen zu können, die bei Absetzen des Aufrufs gültig waren, oder um die Adresse des 
verwendeten Steuerblocks zu übergeben, kann der Benutzer eine Ereignisinformation festle- 
gen. 


Dies geschieht beim Absetzen des YOPNCON, YRECEIVE oder YSENDREC. Sie wird wieder 
übergeben, wenn das Ereignis eingetroffen ist, entweder in einem definierten Feld (ohne 
Contingency) oder in einem Register (in der Contingency). 
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Rückmeldung 


Wurde ein Befehl an DCAM ausgeführt, so erhält der Benutzer nach Abschluß die Rückmel- 
dung. Sie besteht aus einem 4 Byte langen Code der in einem Feld des Steuerblocks ACB bzw. 
RPB hinterlegt wird und zwar im sog. FDBK-Feld. Zusätzlich wird er in Register 15 übergeben 
(siehe Tabelle 4-1). 


: Byte 2 


FDB 2: FDB 3: FDB 4: 
Grund einer Anzeigen Datenanzei- 
Zurückwei- gen 

sung (error code) 


Tabelle 4-1 Aufbau der Rückmeldung 


Die Rückmeldung gliedert sich in mehrere Bytes. Die Auswertung des Bytes 1 (FDB 1) erlaubt 
es schon dem Benutzer, grob zu beurteilen, was ggf. getan werden muß. Das Byte (FDB 2) 
kann er wahlweise auswerten, oder sich mit der Protokollierung begnügen, die eine spätere 
Auswertung erlaubt. Die jeweilige Problemstellung wird letztlich den Ausschlag geben, wie 
hier verfahren wird. 


Die Bytes 3-4 (FDB 3-4) enthalten Zusatzangaben, wie z.B. Nachrichtenstruktur, Transportquit- 
tung oder Nachricht, usw. 


Die Rückmeldungen stehen immer in den FDBK-Feldern der entsprechenden Steuerblöcke. 


Bei einem synchronen Befehl enthält die Rückmeldung Angaben über die Ausführung, bzw. 
Nichtannahme. 


Bei einem asynchronen Befehl sind nach Beendigung des Aufrufs zunächst nur Angaben über 
Annahme oder Nichtannahme des Befehls verfügbar. Register 15 und das FDBK-Feld können 
noch keine Werte enthalten, die die Ausführung des Befehls betreffen. Sie sind erst nach 
Befehlsausführung im RPB-Steuerblock zu finden. Der Benutzer kann den RPB wieder 
auffinden, indem er beim asynchronen Aufruf die RPB-Adresse im Feld ’EIDREF’ übergibt. 
Nach einem SOLSIG erhält er die RPB-Adresse über das Feld 'RPOSTAD’, bzw. Register 3 der 
Contingency zurück. So kann er auf den verwendeten RPB und mit YSHOWCB auf die 
Rückmeldung im FDBK-Feld zurückgreifen. 


In der Rückmeldung des Aufrufs SOLSIG (Register 15) bzw. Register 2 der Contingency erhält 
der Benutzer keine Angaben über die Befehlsausführung durch DCAM, sondern nur über den 
SOLSIG-Aufruf; d.h., nur Angaben darüber, ob das erwartete Ereignis eingetreten ist oder ob 
ein Fehler oder Zeitüberschreitung auftrat (vgl. SOLSIG im Manual ’BS2000 Makroaufrufe an 
den Ablaufteil’). 


Bei einigen Aufrufen (YOPNCON, siehe 3.2.1.2 und Kapitel 3; YRECEIVE, siehe 3.3.2) werden - 
wenn die Rückmeldung keinen Fehler anzeigt (d.h. FDB1 = x’00’), noch weitere Informationen 
übergeben (siehe dazu entsprechende Abschnitte (Kapitel 3) der Funktionsbeschreibung). 
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Asynchrone DCAM-Meldungen 


Für eine Reihe von Ereignissen im Datenkommunikationssystem, die unabhängig vom Verar- 
beitungsablauf des Programms auftreten können, die ferner die Verarbeitung unter Umstän- 
den entscheidend beeinflussen, können von DCAM asynchrone Meldungen erzeugt und dem 
Prozeß übergeben werden (Tabelle 4-2). 


LOGON nur an den die Verbindungsfunk- 
Primärprozeß funktion 

PROCON 

SECOND Existenzfunktion 


COMEND ee 


LOSCON an Primär- oder Verbindungsfunktion 
T SekundarprozeR DD — 


Existenzfunktion 


| Datenübermittlungs- 
funktion 


Tabelle 4-2 Asynchrone DCAM-Meldungen 


Die Ereignisse sind folgende: 

LOGON: 

— Eine Aufforderung zum Aufbau einer Verbindung ist eingetroffen. 
LOSCON: 


— Eine Verbindung wurde vom Kommunikationspartner, dem Operator oder durch Fehler 
abgebaut. 


— Der Abbau einer Verbindung steht bevor (Warnung) siehe /BCON- und /BCTIMES- 
Kommando in Generierung und Administration). 


Hinweis: 


Wenn das LOSCON-Ereignis eintritt und keine Warnung erfolgt, ist die Verbindung schon 
abgebaut; gibt der Benutzer jetzt den Makroaufruf YCLSCON ein, wird er mit einem Return- 
code #0 abgelehnt. 


PROCON: 


— Bereits bei der Generierung des Datenkommunikations-Zugriffssystems (XSTAT-Aufruf in 
Generierung und Administration) festgelegte Partner werden beim YOPEN bzw. einem 
/BCIN-Kommando des Operateurs zum Verbindungsaufbau vorgeschlagen. 


SECOND 
— Ein Sekundärprozeß wurde eröffnet oder geschlossen. 


— Der Verteilcode einer Nachricht ist einem Verteilungsnamen zugeordnet, der von keinem 
Sekundärprozeß eröffnet ist. Um diese Nachricht selbst zu empfangen, muß der Primär- 
prozeß erst YFORBID für den Verteilungsnamen geben. 
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COMEND: 
— Das Kommunikations-Zugriffssystem wurde beendet. 


— Die Beendigung steht bevor (Warnung) (siehe /BCTIMES-Kommando in Generierung und 
Administration). 


— Die DCAM-Anwendung wurde geschlossen (Meldung an Sekundärprozeß). 


— Das Schließen der DCAM-Anwendung steht bevor (Warnung an Sekundärprozeß) (siehe 
/BCTIMES-Kommando). 


EXPR: 
— Eine Expreßnachricht ist eingetroffen. å 


TACK: 
— Eine Transportquittung ist eingetroffen. 


Die DCAM-Anwendung kann von dem sie betreffenden Ereignis unterrichtet werden, wenn 
dies bei ihrer Erzeugung/Eröffnung festgelegt wird. Da die Ereignismeldung zum Ablauf einer 
Contingency führt, muß für eine Meldung, die in Empfang genommen werden soll, eine 
Contingency definiert werden. Dazu ist der Makro ENACO zu verwenden (siehe Makroauf- 
rufe). Das zurückgegebene Kennzeichen (COID) ist über den Ereignissteuerblock ENB (siehe 
auch 3.2.1) an DCAM zu übergeben. Beim YOPEN ist dann für die Lebensdauer einer 
Anwendung festgelegt, welche Meldungen angenommen werden und welche Contingency 
jeweils angestoßen werden soll. 


Primärprozesse erhalten alle Ereignisse gemeldet, Sekundärprozesse nur LOSCON, 
COMEND, EXPR und TACK. Wird eine Contingency angestoßen, enthalten die Register 1-8 alle 
Informationen, die jeweils für die Verarbeitung eines Ereignisses notwendig sind. Alle 
weiteren Register enthalten keinen definierten Inhalt. Somit bleibt auch die Versorgung der 
Basisregister Aufgabe des Benutzers. Der Zugriff auf Registerinhalte der unterbrochenen 
Routine oder der Hauptroutine kann mit dem Makroaufruf CONTXT erfolgen (siehe Makroauf- 
rufe). Die Prioritäten der Contingency-Routinen werden bei ihrer Definition (ENACO) festge- 
legt und können mit LEVCO (siehe Makroaufrufe) verändert werden. 


Auf die LOGON-Meldung wird von DCAM eine Reaktion erwartet. Erfolgt keine Reaktion, so 
wird dies als Zurückweisung der Meldung gewertet. Die Reaktion muß nicht in der Contingen- 
cy-Routine selbst erfolgen, sondern nur innerhalb eines bestimmten Zeitraums, der beim Start 
des Kommunikationssystems (/BCTIMES-Kommando) festgelegt wurde (siehe auch Bild 4-8). 
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Benutzer-Prozeß System 


Hauptroutine 


ENACO: 
Contingency definieren 
Übergabe des 
Contingency- 

Kennzeichens 


a ee 


COID = Kennzeichen der Contingency-Routine 


Bild 4-8 Beispiel für Empfang von Expreßnachrichten über eine asynchrone DCAM- 
Meldung (EXPR) 


Die Entscheidung bei der Erzeugung/Eröffnung der DCAM-Anwendung, bestimmte Meldun- 
gen nicht entgegenzunehmen, hat im einzelnen folgende Konsequenzen: 


e LOGON ist nicht definiert: Aufforderungen zum Aufbau einer Verbindung seitens der 
Kommunikationspartner können nur durch einen im Programmablauf abgesetzten YOPN- 
CON-Aufruf bearbeitet werden. 


e LOSCON ist nicht definiert: Der Verbindungsverlust ist frühestens der Rückmeldung eines 
Aufrufs zu entnehmen, der sich auf diese Verbindung bezieht. 


e SECOND ist nicht definiert: Der Primärprozeß muß auf anderem Weg (P1-Eventing) 
erfahren, daß ein Sekundärprozeß die Anwendung eröffnet hat und welchen Verteilungs- 
namen er hat. 


Der Primärprozeß erfährt nichts über Nachrichten, die einem Verteilungsnamen ohne 
angeschlossenen Sekundärprozeß zugeordnet werden. Diese Nachrichten werden von 
keinem Prozeß empfangen und nach Ablauf einer System-Uberwachungszeit gelöscht. 


e PROCON ist nicht definiert: Vordefinierte Vorschläge zum Aufbau von Verbindungen 
werden nicht an die DCAM-Anwendung gemeldet. 


e COMEND ist nicht definiert: Frühestens beim nächsten Aufruf an DCAM wird durch 
entsprechende Rückmeldung bemerkt, daß die DCAM-Anwendung nicht mehr besteht 
oder das Kommunikations-Zugriffssystem beendet wurde. 


e EXPR ist nicht definiert: Expreßnachrichten müssen in der Reihenfolge der eintreffenden 
Nachrichten mit YRECEIVE abgeholt werden. 


e TACK ist nicht definiert: Transportquittungen müssen in der Folge der eintreffenden 
Nachrichten mit YRECEIVE abgeholt werden. 
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4.1.6 ‘Reentrant’-fahige Assembler-Programme 


Im BS2000 kann ein Programm mehrere Prozesse steuern. Dieses Programm ist für diese 
Anzahl von Prozessen nur einmal geladen. Das bedeutet: 


e Ladezeiten werden verkürzt, denn wenn das Programm vom ersten Prozeß aufgerufen 
wird, wird es geladen. Beim Aufruf durch weitere Prozesse wird es nicht mehr geladen, 
sondern auch von ihnen, eben mehrfach, genutzt. 


e Antwortzeiten bei Dialogen werden verkürzt, denn die DCAM-Anwendung als Kommu- 
nikationspartner hat die ‘Last’ der ankommenden Anfragen auf mehrere Prozesse verteilt. 
So wird die Prozeßsteuerung im ‘time sharing’ ausgenutzt, obwohl nur ein Programm 
dahinter steht (siehe Abschnitt 2.3.1). 


e Die Anlagenausnutzung wird verbessert, denn die Seitenwechselrate (paging) ist gerin- 
ger, und es wird für mehrere Prozesse das Programm nur einmal im Haupt- und 
Seitenspeicher verwaltet. 


Bedingung für diese Verarbeitung ist, daß ein solcher Programmodul, der als ‘shared code’ im 
System verwaltet werden soll, ablaufinvariant und damit ‘reentrant’-fahig ist. Da aber meist 
auch prozeßspezifische Ein-/Ausgabe-Bereiche, usw. benötigt werden, bedeutet dies, daß ein 
Programm in einen ablaufinvarianten (read only) und einen ablaufvarianten (variablen) Teil zu 
unterteilen ist. Von DCAM wird dieses Verfahren unterstützt, indem 


e Steuerblöcke während des Ablaufs in einem von DCAM verwalteten prozeßspezifischen 
Bereich oder in einem Benutzerbereich erzeugt werden können. 


@ bei Aufrufen zur Erzeugung und Behandlung der Steuerblöcke Parameterliste und Befehls- 
teil des Makros (SVC) durch Verwendung des MF-Parameters getrennt erzeugt werden 
können. 


e weitgehend die Register-Schreibweise verwendet werden kann. 
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4-14 


Tabelle 4-3 zeigt zusammen mit Bild 4-9 die Möglichkeiten der ‘Reentrant’-Programmierung 
und die erforderliche Aufteilung des Programms. 


Programmteil 


Befehle 


Daten und Bereiche 


Tabelle 4-3 


Modell A 


Bild 4-9 


ablaufinvariant 
(shared code) 


invarianter Befehlcode 

(ggf. unter Verwendung 

des EX-Befehls) 

- Adressierung des variablen 
Teils über Register (MF=E) 

- ggf. Bereitstellung von 
Speicher für den var- 

iablen Teil (Bild 4-9, 

Modell B) 


Zahlenkonstanten 

- Textkonstanten 

- Adreßdefinition 
DSECT) 

- Parameterlisten 

(MF=L) 


Programmaufbau bei SHARED CODE 


Modelle für “shared code’-Programmierung 


variabel 
prozeßspezifisch) 


Befehlscode incl. 
Versorgung von 
Registern bei 
Sprung zum ablauf- 
invarianten Modul 
(Bild 4-9, 

Modell A) 


Ein-/Ausgabe- 
bereiche 
Rechenfelder 
Sicherstellungs- 
bereiche (Register) 
Paramterlisten 
(MF=L) 
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4.1.7 


4.2 


4.2.1 


Verwendung weiterer Systemschnittstellen 


Für die Verwendung weiterer Systemschnittstellen besteht für ein DCAM-Assembler-Pro- 
gramm keine Einschränkung. Einige Schnittstellen oder Eigenschaften von Schnittstellen 
sind sogar zur Lösung spezifischer Teilhaberprobleme besonders geeignet. 


Im Rahmen der Makroaufrufe an den Ablaufteil stehen dem Benutzer zur Datenübergabe 
zwischen Prozessen und der Synchronisierung von Prozessen der 'Gemeinsame Speicherbe- 
reich’ (Common Memory) mit 'Prozeß-Serialisierung‘ und die ‘Inter-Proze-Kommunikation’ 
zur Vefügung. Eine ereignisgesteuerte Verarbeitung ist möglich bei Verwendung der Schnitt- 
stelle P1 Eventing und Contingency. 


Die Dateibearbeitung mit den Zugriffsmethoden des Datenverwaltungssystems (DVS) kann 
bei ISAM und USER PAM im SHARED UPDATE-Modus ausgefuhrt werden. Dadurch wird der 
Zugriff einer Prozeßgruppe auf eine Datei mit den erforderlichen Schutzmechanismen unter- 
stützt. 


Erstellung eines COBOL-Programms 


Für die Verwendung in COBOL-Programmen wurden eine Reihe von Zugriffsmodulen auf 
DCAM-Funktionen geschaffen, die synchrone und asynchrone Verarbeitung erlauben. 
COBOL-Programme können bei einfachen Anwenderproblemen Primärprozesse steuern, sind 
aber zur Steuerung von Sekundärprozessen auch und gerade bei komplexen Problemen 
geeignet (siehe auch 2.3). 


COBOL-CALLS und Datenstrukturen 


Alle Aufrufe an DCAM werden in Form von Unterprogrammsprüngen (CALL...) formuliert, die 
zugehörigen Datenstrukturen mit den Parametern und Datenfeldern sind in der WORKING- 
STORAGE SECTION zu deklarieren. 


Sechs unterschiedliche Datenstrukturen sind in ihrem Aufbau vorgegeben: 
e Anwendungsstruktur (A-Struktur): 


Beschreibung der DCAM-Anwendung, die im Programm mindestens einmal vorhanden 
sein muß. 


e Verbindungsstruktur (V-Struktur): 


Beschreibung der logischen Verbindung, für jede Verbindung gesondert oder für mehrere 
einmal vorhanden. 


e Befehlsstruktur (B-Struktur): 


Beschreibung eines Befehls, für jeden Befehl gesondert oder für mehrere Befehle einmal 
vorhanden. 


e Verteilungsstruktur (VTLG-Struktur): 


Beschreibung der Nachrichtenverteilung über Verteilcodes, nur notwendig, wenn der 
Nachrichtenempfang so gesteuert werden soll. 


è Wartestruktur (W-Struktur): 


Beschreibung der Operanden zum Warten auf Beendigung von asynchronen CALL-Aufru- 
fen. 


e Datenstruktur (FHS-Struktur): 


Sie ist nur dann notwendig, wenn die Formatierung der Daten mit dem integrierten 
FHS-C-Anschluß erfolgen soll. (Dazu ist das Softwareprodukt FHS ab Version 3.0 Voraus- 
setzung). Die FHS-Module müssen auf der Benutzer-TASKLIB zur Verfügung stehen. 
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Für alle Datenstrukturen stehen COPY-Elemente zur Verfügung: 


YDDCUAPL für die A-Struktur 
YDDCUCON für die V-Struktur 
YDDCUCOM für die B-Struktur 
YDDCUDIS für die VTLG-Struktur 
YDDCUWAI für die Wartestruktur 
FHSMAINP für die FHS-Parameter 


In Tabelle 4-4 ist dargestellt, welche Datenstrukturen in den Aufrufen der einzelnen Unterpro- 
gramme benützt werden. Bei einigen Aufrufen ist ein zusätzlicher Bereich zur Datenübernah- 
me/-gabe erforderlich. 


Einzelne Aufrufe benötigen noch weitere Bereiche, die hier nicht gezeigt werden (siehe dazu 
DCAM-COBOL-Aufrufe). 


Unterprogramm FHS- 
Parameter 


YOPEN 
YCLOSE 
YSETLOG™ 


YOPNCON™ 
YCLSCON” 
YCHANGE™ 
YREJLOG 


YSEND 
YRECEIVE 
YPERMIT ) 
YFORBID' ) 
YRESET 


*) nur im Primärprozeß aufrufbar 


Tabelle 4-4 Unterprogramme und Datenstrukturen 
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Die Unterprogramme erfillen im einzelnen folgende Aufgaben: 


YOPEN: Eroffnen einer DCAM-Anwendung 

YCLOSE: Schließen einer DCAM-Anwendung 

YSETLOG: Ändern des Zustands einer DCAM-Anwendung 
YOPNCON: Aufbau einer logischen Verbindung 

YCLSCON: Abbau einer logischen Verbindung 

YCHANGE: Ändern der Eigenschaften einer Verbindung 
YSEND: Senden einer Nachricht 

YRECEIVE: Empfang einer Nachricht oder Transportquittung 
YPERMIT: Empfang über Verteilcode ermöglichen 

YFORBID: Empfang über Verteilcode verbieten. 

YREJLOG: Zurückweisen der Aufforderung zum Aufbau einer Verbindung 
YRESET: Zurücknahme von anstehenden YRECEIVE-Aufrufen 
YWAIT: Warten auf irgendein DCAM-Ereignis 


Für die Statusabfrage, die Existenz- oder Verbindungsfunktion betreffend, gilt eine besondere 
Vereinbarung. Sie wird mit YINQUIRE aufgerufen. Folgende Abfragen können gemacht 
werden: 


— Welcher Partner wünscht als nächster eine Verbindung aufzubauen (ggf. mit Empfang der 
Verbindungsnachricht im Feld 'LGMSG’)? (TOP) 


— Wieviele Partner wünschen eine Verbindung bzw. mit wievielen besteht eine Verbindung? 
(CNT) 


— Welchen Zustand hat eine bestimmte DCAM-Anwendung? (APP) 
— Welche charakteristischen Eigenschaften hat ein Partner? (PTN) 


Es wird die A-Struktur und die B-Struktur verwendet und es muß ein Bereich angegeben 
werden. Dieser Bereich ist in Abhängigkeit von der Funktion des Aufrufs unterschiedlich 
strukturiert. Die Funktion wird in einem eigenen Feld bestimmt (Tabelle 4-5). 


Unter- Funktion | Bereiche 
programm | der YINQUIRE nn 
ni’) LGMSG 


YINQUIRE 


“) Bereich in Abhängigkeit der Funktion 


Tabelle 4-5 Statusabfrage 
Hinweis: 


Die Unterprogramme können auch mit einem auf die ersten 4 Buchstaben reduzierten Namen 
aufgerufen werden, z.B., YOPNCON’ mit ‘YOPN’. 
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4.2.2 


4.2.2.1 


4.2.2.2 


4.2.3 


Zur einfacheren Handhabung der Programmierung wird empfohlen, die Datenstrukturen 
einmal in einer Quellcode-Datei zu definieren. Das Dienstprogramm COBLUR hilft bei der 
Erstellung einer COBOL- Quellprogrammbibliothek. Mit der COPY-Anweisung können die 
gespeicherten Datenstrukturen jeweils ins Programm übernommen und ggf. modifiziert 
werden. Zur Handhabung bei der Übersetzung des Programms werden in einem eigenen 
Manual Angaben gemacht. 


Ausführung der Aufrufe 


Synchrone Ausführung 


Bei der synchronen Verarbeitung wird der nächste Befehl nach einem Unterprogrammsprung 
erst ausgeführt, wenn der DCAM-Aufruf bearbeitet wurde. In Aufrufen, bei denen Wartezei- 
ten entstehen können, z.B. bei YOPNCON das Warten auf die Aufforderung zum Verbindungs- 
aufbau bzw. die Annahme des Verbindungswunsches seitens des Partners, bei YRECEIVE die 
Ankunft der Nachricht aus dem Datenkommunikationssystem, kann eine maximale Wartezeit 
festgelegt werden. Nach dieser Wartezeit wird der Aufruf beendet. Soll nicht gewartet 
werden, wird der Aufruf sozusagen auf Verdacht abgesetzt und muß ggf. wiederholt werden. 


Asynchrone Ausführung 


Der Aufbau einer Verbindung und der Empfang von Nachrichten kann zu Wartezeiten führen 
(siehe 4.2.2.1). Um den Datendurchsatz zu erhöhen, insbesondere, wenn sehr viele Partner 
bedient werden sollen, können diese Wartezeiten für anderweitige Verarbeitung genutzt 
werden. Mit dem YWAIT-Aufruf kann der Benutzer auf irgendein Ereignis warten. Nach dem 
Eintreffen des Ereignisses kann er seine Verarbeitung fortsetzen. 


Mögliche Ereignisse: 

e OPENED der YOPNCON-Auftrag ist beendet. 

e LETTER der YRECEIVE-Auftrag ist beendet. 

e GOSIGNAL der Speicherplatz-Engpass ist aufgehoben. 

e LOSCON die Verbindung wurde durch das System oder durch den Partner abgebaut. 
e NOEVENT obwohl gewartet wurde, ist kein DCAM-Ereignis eingetroffen. 


Rückmeldung 


Nach Rückkehr aus einer Unterroutine, d.h. nach Ausführung eines DCAM-Aufrufs werden in 
3 Feldern der jeweils benutzten Datenstruktur Rückmeldungen hinterlegt (Anwendungsstruk- 
tur oder Befehlsstruktur). 


Die Rückmeldung ist in 3 Felder gegliedert: 
— Rückgabecode 

— Fehlercode 

— Indikator 


Der Rückgabecode gibt eine Zusammenfassung der Information wieder, die in Fehlercode und 
Indikator weiter entfaltet ist. Er wird heranzuziehen sein, um beispielsweise in eine Fehlerrou- 
tine zu verzweigen. 


In dieser ist dann der Fehlercode festzuhalten, um ihn auswerten zu können. 
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4.2.4 


Der Indikator enthält Zusatzinformationen nach Ausführung des YRECEIVE über Art der 
Transportquittung (positiv oder negativ) oder Klasse der Nachricht (Element, Untergruppe, 
Gruppe; Normal- oder Expreßnachricht). 


Ferner werden nach YRECEIVE Eintragungen in 3 Felder der Befehlsstruktur gemacht: 
— die laufende Nummer der empfangenen Nachricht, 


— die laufende Nummer der quittierten Nachricht (wenn eine Transportquittung empfan- 
gen wurde). 


— die tatsächliche Länge der empfangenen Nachricht (auch wenn der Eingabebereich 
kleiner war). 


Bei weiteren Aufrufen (YOPEN, YOPNCON, YWAIT) werden - wenn die Rückmeldung keinen 
Fehler anzeigt - noch weitere Informationen übergeben (siehe dazu die entsprechenden 
Abschnitte (Kapitel 3) der Funktionsbeschreibung). 


‘Reentrant’ -fähige COBOL-Programme 


Bedingung für die 'Reentrant’-Fähigkeit eines Codes ist, daß er ablaufinvariant geschrieben 
wurde (vgl. 4.1.6). Nur dann kann er auch als “SHARED CODE” im System verwaltet und 
benutzt werden. 


Die COBOL-Übersetzer erzeugen bei Verwendung der Segmentierung ein Wurzel-Segment 
(root), das ablaufvariant ist und mehrere Überlagerungssegmente (overlays), die mit wenigen 
Einschränkungen ablaufinvariant sind. Das Wurzel-Segment enthält die V-Konstanten zum 
Einbinden sowohl der Segmente, als auch des COBOL-Ablaufzeit-Systems (ITL...) und der 
Moduln, die per “CALL” aufgerufen werden. Dieses Segment erhält den Namen, der in der 
"PROGRAM-ID.” angegeben wurde. 


Die Überlagerungssegmente werden vom Wurzelsegment mit “PERFORM” aufgerufen. Ihre 
Namen setzen sich zusammen aus den ersten 3 Stellen des in der PROGRAM-ID.” angegebe- 
nen Namens, einem Nummernzeichen (#) und der Segment-Nummer (z.B. ABC # 50). 


In ihnen dürfen mit “CALL” keine Module aufgerufen werden, die ablaufvariant sind. Dies ist 
aber bei DCAM-COBOL-ModulIn der Fall. Somit können DCAM-Aufrufe in solchen Segmenten 
nicht gegeben werden. 


Bei Verwendung des COB1-Übersetzers wird in den Überlagerungssegmenten ablaufinvarian- 
ter Code erzeugt. 


Wird noch der ANSICOB-Übersetzer verwendet, so gelten die folgenden Einschränkungen: 


— Kein Ansprechen von Datenfeldern, die mit “OCCURS... DEPENDING ON...” definiert 
wurden. 


— Kein”GO TO’ mit “ALTER” erlaubt. 
— Kein DISPLAY” möglich. 


— Kein ’ACCEPT” möglich. 
Ansonsten wird ebenfalls ablaufinvarianter Code erzeugt. 


Bild 4-10 zeigt an einem Beispiel die Segmentierung im COBOL-Programm. 
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ABCDEF z.B. YSEND 


ablaufvariante 
(non-sharable) 
Programmteile 


CALL 


ABC #01 


PERFORM 


ablaufinvariante 
(sharable) 
ABC #02 Programmteile 


PERFORM 


Bild 4-10 Segmentierung eines COBOL-Programms 


Damit nun die Uberlagerungssegmente auf ihre Ablaufinvarianz (Read-only-Eigenschaft) 
getestet werden können, muß beim Eintrag in eine Modul-Bibliothek mit dem Dienstpro- 
gramm LMR die TRAITS-Anweisung verwendet werden. Dies ist deshalb notwendig, weil die 
COBOL-Übersetzer derzeit diese Eigenschaft nicht explizit prüfen. 


Der ANSICOB-Übersetzer erzeugt am Anfang eines Moduls eine Bindesteuerkarte (OVER- 
LAY...), um das Überlagerungssegment zu kennzeichnen. Beim LMR-Lauf werden diese 
wieder entfernt mit einer entsprechenden Meldung. Für die weitere Bearbeitung mit dem 
dynamischen Bindelader (DLL) ist das notwendig und daher in Ordnung. Nur der dynamische 
Bindelader (DLL) kann “SHARED CODE” laden und muß in diesem Fall verwendet werden. Er 
wird mit 


/EXEC (modulname, bibliotheksname) oder 
/LOAD (modulname, bibliotheksname) 
aufgerufen. 


SHARED-Module werden allerdings nur dann in den Klasse 4-Speicher des Systems geladen, 
wo sie für alle Prozesse zugänglich sind, wenn sie zu Beginn der BS2000-Sitzung vom 
Systemverwalter in die entsprechende Modultabelle des Systems aufgenommen wurden 
(siehe Systemüberwachung/ SHARE-Kommando). 
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Programmierer: 


Modulbiliothek 
„BIBLIO“ 


. _ ‚ablauf- 
U210 SECTION 50. | un 


Le 


Systemverwalter: 


(ABC # 50, ABC# 51, ABC #80), BIBLIO 


SHARE-TABELLE 
ABC# 50 


ABC# 51 
ABC# 80 


Benutzer: 


/ ges (ABCDEF, BIBLIO) 
oaer 
/ EXEC (ABCDEF, BIBLIO) 


Klasse-6-Speicher (prozeBspezifisch) Klasse-4-Speicher (systemglobal) 


Bild 4-11 Erzeugen von SHARED CODE 
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4.2.5 Verwendung weiterer Systemschnittstellen 


Im Rahmen der COBOL-Anwendung im BS2000 gibt es für ein DCAM-COBOL-Programm 
keine Einschränkungen. 


Besonders hingewiesen werden soll auf die Möglichkeit bei den Zugriffsmethoden USER PAM 
und ISAM des Datenverwaltungssystems den SHARED UPDATE-Modus zu verwenden. Er 
stellt für den Zugriff einer Prozeßgruppe auf eine Datei die erforderlichen Schutzmechanis- 
men zur Verfügung (siehe DVS). 
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4.3 


4.3.1 


Ausführung eines DCAM-Programms: DCAM-Prozeß 


Ein DCAM-Prozeß ist zunächst ein beliebiger Prozeß des BS2000. Sobald innerhalb dieses 
Prozesses ein Programm eine DCAM-Anwendung eröffnet, wird das Taskattribut auf ”TP” 
(transaction processing) gesetzt (siehe auch Bild 4-12), falls im JOIN-Eintrag erlaubt. 


Stapel-oder Prozeß mit Stapel- oder 
Dialogprozeß Taskattribut “TP” Dialogprozeß 


im 111 urn c—_“ 


Przoeßtyp 


Zeit 


/LOGOFF 


Kommando-Modus /LOGON /EXEC 


Programm-Modus erstes YOPEN letztes YCLOSE TERM 


Bild 4-12 Prozeß-Typen 


Starten eines DCAM-Prozesses 


Bevor ein Prozeß zum DCAM-Prozeß werden kann, wird er als Stapel- oder Dialogprozeß mit 
dem Kommando /LOGON (siehe Kommandosprache) gestartet. Dieses Kommando kann 
gegeben werden 


— für Stapelprozesse auf Lochkarten, die lokal (über Lochkartenleser) oder fern (über 
Stapelstation 8418) eingegeben werden. 


— für Stapelprozesse von anderen Prozessen aus durch sogenannte ENTER-Dateien, in 
denen als erstes ein /LOGON-Kommando vorhanden ist. Stapelprozesse werden vom 
System gestartet, wenn die Betriebsmittel bereit stehen und die vom Systemverwalter 
gesetzte Begrenzung dies erlaubt. 


— für Dialog-Prozesse von einer beliebigen dialogfähigen Datenstation aus, z.B. einer 
Datensichtstation 8161. In diesem Fall wird der Prozeß sofort gestartet. 


Hinweis: 


Bereits mit dem Prädialog (siehe Anleitung für Datenstationsbenutzer) wird die logische 
Verbindung zwischen einer Datenstation und einer Anwendung aufgebaut. Bei Teilnehmer- 
Prozessen ist dies die Verbindung zwischen der Datenstation und der Anwendung ‘$ DIA- 
LOG’. Nachdem ein solcher Prozeß zum DCAM-Prozeß wurde, besteht nach wie vor die 
Verbindung zur Datenstation und somit ist es nicht möglich, von dieser Datenstation aus zu 
dem den Prozeß steuernden DCAM-Programm eine Verbindung aufzubauen. Von dieser 
Datenstation aus kann aber das Programm mit DTH getestet und überwacht werden (siehe 
auch Bild 4-13). 
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BS 2000 


Logische Verbindung und 


DTH- 
Kommandos 


Logische Verbindung und Datenverkehr 


Datenverkehr mit mit der 
dem DialogprozeB im DCAM-Anwendung 
Teilnehmerbetrieb im Teilhaberbetrieb 


über die Systemanwendung 
» DIALOG” 


Bild 4-13 Teilnehmer- und Teilhaberbetrieb in einem Prozeß 


4.3.2 Beenden eines DCAM-Prozesses 


Ein DCAM-Prozeß erhält sein ursprüngliches Taskattribut, sobald das ihn steuernde Pro- 
gramm die letzte DCAM-Anwendung schließt, bzw. das Programm beendet wird. Danach wird 
er wie vorher als Stapel- oder Dialogprozeß geführt und mit dem /LOGOFF-Kommando 
beendet. Dies kann gegeben werden: 


— füreinen Stapelprozeß auf einer Lochkarte in einem Kartenstapel; 
— als letztes Kommando in einer ENTER-Datei; 
— als Eingabe von der Dialogstation; 


— im Programm-Modus durch den LOGOFF-Makro oder indirekt durch TERMJ-Makro, wenn & 
auf /LOGOFF gesprungen wird. 


Ferner können Prozesse beendet werden durch 
— das /CANCEL-Kommando des Operators oder 


— das /CANCEL-Kommando im Dialogprozeß für Prozesse gleicher Benutzerkennung, aber 
anderer TSN; 


— das /SHUTDOWN-Kommando des Operators; 
— durch ’ABNORMAL TASK TERMINATION’ bei einem Systemfehler. 
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Anhang 


A.1 DCAM-Aufrufe 


Arten der Aufrufe an DCAM: 


— Makroaufrufe (Assembler = A) 
— Call-Aufrufe (COBOL = C) 


A YAPPL Namen- 
Zuweisung 
A; C | YCHANGE Verbindung 


A; C | YCLSCON Verbindung 


A YCONN Namen- 


Zuweisung 


A YDCG 


A YDDACB 


A YDDCCB 


YDDDCG 


A YDDDIP 


A YDDENB 


A YDDRPB 


A YDIP 


A YENB 


D> 
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DCAM-Aufrufe 


Beschreibung 

Erzeugen eines Anwendungssteuerblocks A 
Speichern von Angaben zur DCAM-Anwen- 

dung in der CLT und auch Löschen dieser 

Angaben 

Erzeugen eines Verbindungssteuerblocks 


Ändern von Eigenschaften einer bereits 
aufgebauten Verbindung 


Schließen einer DCAM-Anwendung 


Rücknahme einer Aufforderung oder 
Abbau einer logischen Verbindung 


Speichern von Angaben zur Verbindung 
in der CLT und auch Löschen dieser 
Angaben 


Erzeugen eines Verteilcode-Gruppenblocks 


Erzeugen eines (Pseudo-)Abschnitts für 
den Steuerblock ACB 


Erzeugen eines (Pseudo-)Abschnitts für 
den Steuerblock CCB 


Erzeugen eines (Pseudo-)Abschnitts für 
den Steuerblock DCG 


Erzeugen eines (Pseudo-)Abschnitts für 
den Steuerblock DIP 


Erzeugen eines (Pseudo-)Abschnitts für 
den Steuerblock ENB 


Erzeugen eines (Pseudo-)Abschnitts für 
den Steuerblock RPB 


Erzeugen eines Veteilungsparameterblocks 
Erzeugen eines Ereignis-Meldungsblocks, 


der asynchrone Meldungen mit Contin- 
gency-Routinen verknüpft. 


A1-1 


DCAM-Aufrufe 


Art 
A: G 
A 

A: -G 
A: G 
A: 
A: G 
oo 
A 

C 

A 

A G 
A 

A G 
A 

A 

C 

A 
AG 


Aufruf 


YFORBID 


YMODCB 


YOPEN 


YOPNCON 


YPERMIT 


YRECEIVE 


YREJLOG 


YRESET 


YRPB 


YSEND 


YSENDREC 


YSETLOG 


YSHOWCB 


YTESTCB 


YWAIT 


YGENCB 


YINQUIRE 


Datenüber- 
mittlung 


Verbindung 


Datenüber- 
mittlung 
Datenüber- 
mittlung 
Verbindung 
Datenüber- 
mittlung 
Datenüber- 
mittlung 


Datenüber- 
mittlung 


Existenz 


Existenz; 
Verbindung 


“) Steuerblock-Funktionen 


A1-2 


Beschreibung 


Aufhebung einer Zuordnung des Vertei- 
lungsnamens zu einer Verteilcodegruppe 


Ändern von Feldern in bestehenden 
Steuerblöcken 


Eröffnen einer DCAM-Anwendung 
Aufbau einer logischen Verbindung 


Zuordnung des Verteilungsnamens zu 
einer Verteilcodegruppe 


Empfang einer Nachricht, Expreß- 
nachricht oder Transportquittung 


Zurückweisen einer Aufforderung zum 
Verbindungsaufbau 


Zurücknehmen von Empfangsaufrufen; 
Ändern des CS/CA-Zustands 


Erzeugen eines Anforderungsparameter- 
Blocks 


Senden einer Nachricht oder Expreß- 
nachricht 


Kombiniertes Senden einer Nachricht 
oder Expreßnachricht und Empfangen 
einer Nachricht, Expreßnachricht oder 
Transportquittung 


Ändern des Zustands einer Anwendung 


Übertragen einzelner Feldinhalte aus 
einem Steuerblock in den Benutzerbereich 


Vergleichen eines Feldinhalts in einem 
Steuerblock mit einem vorgegebenen 
Wert 


Warten auf Beendigung von asynchronen 
CALL-Aufrufen 


Erzeugen eines oder mehrerer Steuer- 
blöcke einer beliebigen Art 


Abfrage von Informationen über Anwen- 
dungen und logische Verbindungen 
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A.2 


Grenzwerte 


Grenzwerte 


e Asynchrone Verarbeitung 


Folgende Tabelle zeigt, wieviele asynchrone Befehle gleichzeitig bearbeitet werden können. 


Maximale Anzahl Gültig für Aufruf-Typ Funktion 


8 je Anwendung YOPNCON ACCEPT ANY Aufforderung eines beliebigen 
Partners annehmen 


8 je Anwendung YOPNCON ACCEPT SPEC Aufforderung eines bestimmten 
Partners annehmen. 


8 je Anwendung YOPNCON ACQUIRE Aufforderung ausgeben 


8 je Prozeß einer | YRECEIVE ANY Empfangen einer Nachricht oder 


Anwendung Transportquittung von einem be- 
liebigen Partner 

8 je logischer YRECEIVE SPEC Empfangen einer Nachricht oder 

Verbindung Transportquittung von einem 


bestimmten Partner 


e Verteilcode-Verwendung 


Folgende Tabelle zeigt die Maximalwerte für die Definition und Zuordnung von Verteilcodes 


Art oberer Gültig für 


Verteilcode-Gruppen je logischer Verbindung COBOL 
Assembler 


Verteilcodes je Codegruppe Assembler, COBOL 


Prozesse je Verteilungsnamen Assembler, COBOL 


e Ein Prozess kann gleichzeitig eine bestimmte Anzahl DCAM-Anwendungen eröffnet 
haben. Wieviele es maximal sein können, geht aus der jeweiligen Freigabemitteilung des 
BS2000 hervor. 


Zusätzlich ist die Zahl der ‘nicht vordefinierten Anwendungen’ begrenzt (siehe Manual 
‘Administration und Dienste eines Datenkommunikationssystems’, Kommando 
DCSTART). Sie kann auf einen Prozeß oder auf das gesamte System bezogen sein. Diese 
Grenzwerte werden beim Systemstart festgelegt und können im Betrieb modifiziert 
werden. 


Eine Anwendung kann gleichzeitig nur eine bestimmte Anzahl Verbindungen unterhalten. 
Zusätzlich ist die Zahl der Verbindungen, die eine ‘nicht vordefinierte Anwendung’ (vgl. 
oben) unterhalten darf, begrenzt. 
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Grenzwerte 


@ Maximale Nachrichtenlange (MAXLN) 


Lokaler Parameter, der die Ökonomie der vom System bereitgestellten Puffer beeinflußt. 
Er enthält die maximale Länge der zu sendenden Daten (Transport Service Data Unit, 
TSDU). 


Bei EDIT = USER: 
1 Nachricht = 1 TSDU (YSEND) 


Bei EDIT = SYSTEM, EDITOUT = PHYS oder FORM: 


DCAM sendet die vom System editierte Nachricht in Teilstücken, die abhängig sind von 
MAXLN und der Gerätekapazität. Die Beachtung der Geräte-Kapazität liegt beim Benutzer. 


Beim Editieren wird abgeschnitten, falls ein editierter Satz größer als MAXLN ist. 
Größtmögliche Anwender-Nachricht je YSEND: 32767 Bytes. | 
Hinweis 


Ein editierter Satz ist stets länger als Anwenderdaten, da Kontrollzeichen umgewandelt 
und Protokolletiketten hinzugefügt werden. 


Folgende Tabelle zeigt die Maximalwerte für MAXLN: 


+- 65530 Default-Wert 


(*) Die Resultate sind abhängig von der HW/SW-Konfiguration und von der Generie- 
rung. 


mit DAST 


e Betriebsmittel-Grenzwerte 


In DCAM V8.0 gelten die folgenden statischen Maximalwerte: 


Anwendungen in DCAM 255 
GID/Anwendung (permitted) 32 
GID/Anwendung (not permitted) 32 
DID/Anwendung 32 


Durch den Name Manager des BS2000 ist die Zahl der Anwendungen plus die Zahl der 
P1-Ereignisse pro Prozeß auf etwa 250 begrenzt. 


Durch BS2000 ist die Anzahl der für einen Prozeß erzeugten und noch nicht abgelaufenen 
P1-Contingencies begrenzt (im BS2000 V7.5 sind maximal 400 Picontingencies möglich). 
Dieser Wert kann ggf. durch einen REP im BS2000 verändert werden (vgl. dazu die Freigabe- 
mitteilungen für DCAM). 
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Verbindungsaufbau von der Datenstation 


A.3 Verbindungsaufbau von der Datenstation 


Der Aufbau einer logischen Verbindung von einer Datenstation wird unterschiedlich erfolgen, 
je nach dem wie die Datenstation generiert wurde, welche Voreinstellungen vorgenommen 
wurden und wie der Kommunikationspartner DCAM-Anwendung den Verbindungsaufbau 
vorgesehen hat. Auf den folgenden Übersichtsbildern werden zwei grundsätzlich verschie- 
dene Methoden gezeigt: 


d.h.: 


e Die DCAM-Anwendung, die als Partner benötigt wird, ist bereits eröffnet. 


e Die Datenstation ist eingeschaltet und betriebsbereit. 


e Die physikalische Verbindung (Leitung) wurde bzw. wird durch eine der drei folgenden 
Maßnahmen aufgebaut: 


— Der Bediener der Datenstation hat sie aufgebaut. 
— Die Leitung ist eine Standleitung und braucht darum nicht aufgebaut zu werden. 


— Der Kommunikationsrechner, an dem die Datenstation angeschlossen ist, baut die 
Leitung auf, ausgelöst durch den Aufruf YOPNCON ACQUIRE im DCAM-Programm. 
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Verbindungsaufbau von der Datenstation 


Initiative bei der Datenstation (DCAM-Anwendung mit Attribut LOGON): 


Generierung Datenstation 


Aufforderung durch Tasten: 
ETX, DU (8103, 8110, 8150, 8151) 
F3 (8152) 

DU (8161) 


PREDIAL = NEIN, 
PARTNAM = partnername, 
PARTPRO = pp/rrr, 

CONPRP = NEIN 


oder 
PREDIAL = JA, 
PARTPRO = pp/rrr 


oder 


PREDIAL = JA 


Aufforderung durch Prädialog: 
PLEASE ENTER NET COMMAND 
OLPNCON] 
partnername 
L,OPCH = name] 
[L,PW = kennwort] 
[,MSG = nachricht] 
C’string 


Warteschlange 
der Auffor- 
derungen 


LIND = 


YOPNCON ACCEPT 


oder 


oder 


REJECTED, reason 
REJECTED, reason 
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Verbindungsaufbau von der Datenstation 


Initiative bei der DCAM-Anwendung (mit Attribut NLOGON eröffnet): 


PREDIAL = NEIN, 
PARTNAM = partnername, 
PARTPRO = pp/rrr, 


Nach YOPEN: 


PROCON-Meldung 


CONPRP = JA, 
APLNAM = partnername 


oder 


PREDIAL = NEIN, 
CONPRP = NEIN 


Beginn des 
Dialogs mit der 
DCAM-Anwendung 


Annahme der 
Aufforderung 


YOPNCON ACQUIRE A 


oder 
keine Datenüber- 
mittlung möglich keine Maßnahme 
') siehe XSTAT-Makroaufruf in [73] 


*) Kommunikationsrechner muß mit /BCIN- und BCACT-Kommando aktiviert worden sein (siehe [73]) 
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Erlauterung der TRANSDATA-Begriffe 


A 

Administration: 
Administrator: 
Administrationsplatz 


(administration console) 


Administrationssteuerung 
(administration manager) 


Administrationszentrum 
(administration center) 


Aufforderung zum Aufbau 
einer Verbindung 
(connection request) 


Befehl 
(instruction) 


Benutzerservice 
(user service) 


D 


[DCAM-] Anwendung 
([DCAM] application) 


[DCAM-] 
Anwendungsprogramm 


([DCAM] application programm) 


[DCAM-] 


Datenübermittlungsfunktion 


([DCAM] data transmission 
function) 


[DCAM-]Ereignis 
([DCAM] event) 
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Querverweise sind durch Kursivdruck gekennzeichnet 


[TRANSDATA-JAdministration 
[TRANSDATA-JAdministrator 


Einrichtung, die den Menschen als Adminis- 
trator mit dem Administrationszentrum 
verbindet. 


Instanz im Verarbeitungs- und Kommunika- 
tionsrechner, die die Auftrage des 
Administrationszentrums ausführt und diesem 
Betriebsereignisse meldet. 


Partner des Administrators. 
Es steuert den Betriebslauf durch Aufträge 
an die Administrationssteuerungen. 


Forderung eines Kommunikationspartners 
an das Datenkommunikationssystem, die 
logische Verbindung zu einem anderen 
Kommunikationspartner aufzubauen. 


(DIN 44300) 


Dienstleitungen für einen der beiden 
Kommunikationspartner, die Nachrichten 
ubermitteln. Der Benutzerservice setzt sich 

aus Stations- und Portservice 

zusammen, die auf den jeweiligen Kommunika- 
tionspartner bezogen sind. 


Kommunikationsanwendung, die von 

mindestens einem DCAM-Anwendungsprogramm 
gesteuert wird. Sie wird in einem oder 

mehreren DCAM-Prozessen erzeugt. 


Benutzerprogramm, das die Dienste der 
Zugriffsmethode DCAM benutzt. Es steuert die 
DCAM-Anwendung. 


Durch Befehle und Meldungen 

ausgedrückte DCAM-Funktionen, die im 
Zusammenhang mit Senden und Empfangen von 
Nachrichten und Quittungen stehen. 


Eines aus einer Reihe von DCAM-spezifischen 
Ereignissen, die zur Koordinierung 
bestimmter Vorgänge im Datenkommuni- 
kationssystem verwendet werden. Es trifft 


[DCAM-] Existenzfunktion 
([DCAM] existence function) 


[DCAM-] 
Namen-Zusweisungsfunktion 
([DCAM] name assignment 
function) 


[DCAM-] Prozeß 
([DCAM] task) 


[DCAM-] Statusfunktion 
([DCAM] status function) 


[DCAM-] Steuerblockfunktion 
([DCAM] control block function) 


[DCAM-] Verbindungsfunktion 
([DCAM] connection function) 


([DCAM] distribution code) 


Dialognachricht 
(dialog message) 


Dialogschritt 
(dialog step) 


Daten 


Datenfernverarbeitungs- 
system = DFV-System 
(teleprocessing system) 


vom Programmablauf zeitlich entkoppelt ein 


(= asynchron eintretendes Ereignis). 


Durch Befehle und Meldungen ausgedrkckte 
DCAM-Funktionen, die im Zusammenhang mit der 
Erzeugung und Auflösung von DCAM-Anwen- 
dungen stehen. 


Durch Befehlebzw. Kommandos 

ausgedrückte DCAM-Funktionen, die es dem 
Benutzer erlauben, die Benutzerprogramme 
unabhängig von aktuellen Parameterwerten 

wie DCAM-Anwendungsname, Partnername usw. 
zu erstellen. 


Ein Prozeß, der durch einen expliziten 
DCAM-Aufruf eine DCAM-Anwendung 

eröffnet hat (Primärprozeß) bzw. sich 

einer bestehenden DCAM-Anwendung bekannt 
gemacht hat (Sekundärprozeß). 


Durch einen Befehlausgedrückte 
DCAM-Funktionen, durch die eine DCAM- 
Anwendung Information über sich 

und über Kommunikationspartner 
erfragen kann. 


Befehle der DCAM-Schnittstelle die zur 
Erzeugung sowie der Manipulation von | 
Steuerblöcken dienen. Alle DCAM-Makroauf- 
aufrufe beziehen sich auf diese Steuer- 
blöcke. 


Durch Befehle und Meldungen 

ausgedrückte DCAM-Funktionen, die im 
Zusammenhang mit Aufbau und Abbau von logischen 
Verbindungen stehen. 


definierte Zeichenfolge mit der für die 
Verteilung der Nachricht innerhalb einer 
DCAM-Anwendung besorgt wird; die Code- 
position in der Nachricht ist beliebig, 

ihre Länge begrenzt. 


Nachricht, die eine Antwort erfordert 

oder eine Antwort ist. 

Die erste Nachricht ist bei UTM die 

Anfrage eines TRANSDATA-Kommunikations- 
partners. Damit beginnt er einen 

Vorgang oder setzt ihn fort. 


Teil eines Vorgangs. Er beginnt mit 

einer Dialognachrichtan einen 
TRANSDATA-Kommunikationspartner und 
endet mit dessen Antwort. 

(DIN 44300) 


Gesamtheit eines Systems mit Datenverar- 
beitung und Datenkommunikation. 
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Datenflußsteuerung 
(data flow control) 


Datenkommunikationssystem 
(data communication system) 


Datenquelle 
(data source) 


Datensenke 
(data sink) 


Datenstation 
(terminal) 


Datenstationsbenutzer 


(terminal user) 


Datenstationsrechner 
(terminal computer) 


Datenübermittlung 
(data communication) 


Datenübertragungsnetz 


(data transmission network) 


Datenübertragungsvorrechner 
(local communication computer, 
front end processor) 


Datenverarbeitungssytem 
(data processing system) 


Digitales Rechensystem 
(digital data processing system) 


Expreßnachricht 
(express message) 
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Kapazitatssteuerung auf dem Weg der 
Nachricht durch das Datenüber- 
tragungsnetz. 


Komplexe Einrichtung aus Hardware--und 
Softwareprodukten, die es zwei oder 
mehreren Kommunikationspartnern 


‚ermöglicht, unter Beachtung bestimmter 


Regeln Daten auszutauschen. 


(DIN 44302) 


(DIN 44302) 


(DIN 44302) 


Mensch, der eine Datenstation benutzt, 
um mit einem TRANSDATA-Kommunikations- 
partner Daten auszutauschen. 


Kommunikationsrechner, an den Daten- 
stationen angeschlossen sind. In ihm | 
laufen Kommunikationsanwendungsprogramme - 
zur Datenstationssteuerung und Datenverar- 
beitung ab. 


(DIN 44302) 


Summe der Hardware- und Softwareeinrich- 
tungen, die die physikalische Ubertragung von 
der Datenquelle zur Datensenke ermöglicht. 


Kommunikationsrechner, der direkt am 
E/A-Kanal des Verarbeitungsrechners 
angeschlossen ist. 


(DIN 44300) 


(DIN 44300) 


Nachrichtbegrenzter Länge an eine 
DCAM-Anwendung oder an eine Daten- 
station, die mit höherer Priorität 

als Normalnachrichten übermittelt und 
zugestellt wird. 


F 


Format-Datenstation 
(format terminal) 


Freilaufende Nachricht 
(unsolicited message) 


K 


Knotenservice 
(node service) 


[Kommunikations-] 
Anwendung 
([communication] application) 


[Kommunikations-] 
Anwendungsprogramm 
([communication] 
application program) 


Kommunikationspartner: 


[Kommunikations-] Protokoll 
([communication] protocol) 


Kommunikationsrechner 
(communication computer) 


Kommunikationszugriffs- 
system 


(communication access system) 


L 


Logische Datenstation 
(virtual terminal) 


Logische Verbindung 
(virtual connection) 


Typ einer logischen Datenstation. Die 
Datenstruktur wird durch Felder mit unter- 
schiedlichen Eigenschaften gebildet. 


Nachricht, die keine Anwort erfordert 

und keine Anwort ist. 

Sendet sie ein Datenstationsbenutzer an 

ein Anwendungsteilprogramm, erhalt er eine 
Standardquittung von UTM. Sendet sie ein 
anderer TRANSDATA-Kommunikationspartner, 
entfällt die Standardquittung von UTM. 


Dienstleistungen fur die Behandlung von 
Nachrichten von und zu Prozessor- 
knoten. 


Instanz zur Verarbeitung von Daten, 
die zwischen Kommunikationspartnern 
ausgetauscht werden. 


Verarbeitungsvorschrift zur Steuerung der 
Kommunikationsanwendung. Sie benutzt die 
Schnittstellen eines Kommunikations-Zu- 
griffssystems. 


[TRANSDATA-] Kommunikationspartner 


Beschreibung der Ubergabebedingungen und 
Ubergabeformate zwischen gleichartigen 
funktionalen Schichten im Datenkommuni- 
kationssystem (Benutzerservice, Transport- 
service, Netzservice). 


Rechnerzum Aufbau von Datenfernverar- 
beitungssystemen. 


Menge der Software-Komponenten eines 
Betriebssystems, die den Anwendungen 
Schnittstellen zur Kommunikation bieten. 


Modellvorstellung einer Datenstation, 
deren Funktionen auf die physikalischen 
Eigenschaften unterschiedlicher Daten- 
stationen abgebildet werden. 


Zuordnung zweier Kommunikationspartner, 


die es ihnen ermöglicht, Daten mit- 
einander auszutauschen. 
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mehrfach benutzbare 


DCAM-Anwendung 


(sharable DCAM application) 


Nachricht 
(message) 


Netzknotenrechner 


(remote communication 
computer; remote front 


end processor) 


Netzservice 
(link service) 


P 


[PDN-] Anwendung 
([PDN] application) 


Port 
(port) 


Portservice 
(port service) 


Primärprozeß 
(primary task) 


Programm 
(program) 


Prozessorknoten 
(processor node) 
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DCAM-Anwendung, die von mehreren 
DCAM-Prozessen gleichzeitig benutzt 
werden kann. 


(DIN 44300) 


Kommunikationsrechner, der nicht direkt 
an einen Verarbeitungsrechner ange- 
koppelt ist und dessen Aufgabe auf die 
Datenkommunikation beschränkt ist. 


Dienstleistungen, die sich aus Knoten- 
service und aus dem Portservice 
zusammensetzen, der auf andere Prozessor- 
knoten bezogen ist. 


Kommunikationsanwendung im Kommunika- 
tionsrechner, die die Schnittstellen des 
Kommunikationszugriffssystems im 
TRANSDATA PDN benutzt. 


Einrichtung für den Datentransfer 
zwischen einem Prozessorknoten und 
seiner Umgebung. 


Dienstleistungen zum Transfer von Daten 
zwischen einem Prozessorknoten und 
seiner Umgebung (Kommunikationsan- 
wendungen, Nahperipherie-Geräte, 
Datenstationen, andere Prozessor- 
knoten). 


Prozeß, der eine DCAM-Anwendung 
eröffnet und deren Charakteristika 
bestimmt. 


(DIN 4430) 


Netzweit andressierbare Instanz im 
Verarbeitungs- oder Kommunikations- 
rechner, in der die Leistungen des 
Transportservices erbracht werden. 


Rechner 
(computer) 


Region 
(region) 


S 
Sekundärprozeß 


(secondary task) 


Station 
(station) 


Stationsservice 
(station service) 


7 
Transaktion: 


[Transaktions] Anwendung 
([transaction] application) 


[Transaktions] 
Anwendungsprogramm 
([transaction] application 
program) 


[Transaktions] Auftrag 
([transaction] job) 


Transaktionscode = TAC 
(transaction code) 


[Transaktions] Sitzung 
([transaction] session) 


(DIN 44300) 


Teilgebiet des Datenkommunikations- 
systems. Sie enthalt einen oder 

mehrere Prozessorknoten, die zum 

Zwecke der Adressierung aus der Sicht des 
Transportservices zusammengefaßt sind. 


Prozeß, der sich an eine geöffnete 
DCAM-Anwendung anschließt und deren 
Betriebsmittel mitbenutzt. 


Aus der Sicht des Transportservices 
netzweit adressierbare Endstelle des 
Datenkommunikationssystems. 


Dienstleistungen für die Vereinfachung 
der Datenübermittlung durch 
Behandlung der Nachrichten von und zu 
Kommunikationspartnern. 


Vorgang 


Kommunikationspartner, an den 
Transaktionsauftrage gerichtet werden 
und der die gewunschten Vorgange ab- 
wickelt. 


Verarbeitungsvorschrift, um die Anwendung 
zu steuern. Es benutzt die Programmschnitt- 
stelle des Transaktionssystems. 


Anweisung an die Anwendung, einen 
Vorgang durchzuführen. 


Information, um einen Vorgang zu 
steuern. 

Bei UTM dient der TAC dazu, die 
Anwendungsteilprogramme anzusteuern. 


Zeitraum, in dem ein Kommunikations- 
partnererteilen kann. Es ist begrenzt 

durch Zuteilung und Rückgabe bestimmter 
Befugnisse. 
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Transaktionssystem 
(transaction system) 


[TRANSDATA-] Administra- 
tion 
([TRANSDATA] administration) 


[TRANSDATA-]Administrator 
([TRANSDATA] administrator) 


[TRANSDATA-] 
Kommunikationspartner 
([TRANSDATA] communication 
partner) 


Transportquittung 
(transport acknowledgement) 


Transportservice 
(transport service) 


U 


[UTM-] Anschlußprogramm 
([UTM] linkage program) 


[UTM]Anwendung 
(UTM application) 


[UTM-] Anwendungsprogramm 


([UTM] application program) 


[UTM-] Anwendungs- 
Teilprogramm 
([UTM] application) 
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Menge der Softwarekomponenten, die die 
Schnittstellen der Anwendung zur Umwelt 
bilden. Es steuert und überwacht 

Vorgänge. Es bedient sich der 

Leistungen des Betriebssystems, insbesondere 
des Kommunikationszugriffssystems und 
Datenbanksystems. 


Inbetriebnahme, Steuerung und Verwaltung 
der TRANSDATA-Komponenten eines Daten- 
fernverarbeitungssystems. 


Mensch oder Programm, dem die 
Administration obliegt. 


Instanzen, die /ogische Verbindungen 
unterhalten und Datenmiteinander 
austauschen. 


Meldung über Abschluß oder Abbruch einer 
Datenübermittlung 


Dienstleistungen für den Datenaustausch 
zwischen Kommunikationspartnern. Er 
veranlaßt und kontrolliert den Transport 
der Nachrichten durch das Datenüber- 
tragungsnetz und verwaltet /ogische 
Verbindungen. 


UTM-Anwendungsteilprogramm, das vom 
System bereitgestellt wird. Der Benutzer 

definiert lediglich seinen Umfang. Es 

schließt das Anwendungsprogramm an den UTM 
an. Jedes Anwendungsprogramm enthält ein 
solches Programm. 


Kommunikationspartner, an den 
Datenstationsbenutzer, UTM-Anwen- 

dungen und andere TRANSDATA-Kommunika- 
tionspartner Transaktionsaufträge 

richten konnen. Die Anwendung wickelt die 
gewunschten Vorgange ab. Sie wird 

generiert und durch das Anwendungs- 
programm gesteuert. 


Verarbeitungsvorschrift, um die UTM-An- 
wendung zu steuern. Es benutzt die UTM- 
Programmschnittstelle und besteht aus dem 
UTM-AnschluBprogramm und den Teil- 
programmen des Benutzers. 


Abgeschlossener Teil eines UTM-Anwender- 
teilprogramms, der ein Teilprogramm einer 
Anwendung bearbeitet. Es wird durch den 
Transactionscode adressiert. UTM startet 
das Teilprogramm, wenn dafür eine Nach- 
richt vorliegt. Ein Teilprogramm führt 
höchstens einen Dialogschritt aus. 


UTM-Datenstation 
(UTM terminal) 


[UTM-] Dialogschritt 
([UTM] dialog step) 


[UTM-] Transaktion 


[UTM-] Transaktions 
Auftrag 
([UTM] transaction job) 


[UTM-] Transaktions Sitzung 
([UTM] transaction session) 


[UTM-] Vorgang = [UTM-] 
Transaktion 
([UTM] transaction) 


V 


Verarbeitungsrechner 
(host computer) 


Verarbeitungssubsystem 
(processing subsystem) 


Datenstation, die durch ihren Namen 
existiert. Sie entsteht bei der Generierung 
der UTM-Anwendung und entkoppelt sie 
vom Datenübertragungsnetz: Eine 
UTM-Datenstation kann für mehrere physi- 
kalische Datenstationen stehen. 

Mehrere UTM-Datenstationen können für 
eine physikalische Datenstation stehen. 
Eine UTM-Datenstation kann für einen 
beliebigen TRANSDATA-Kommunikations- 
partner stehen. Die Zuordnung kann 
während des Betriebs per Administrations- 
kommando geändert werden. 


Teil eines Vorgangs. Er beginnt mit einer 
Dialognachricht, die vom Daten- 
stationsbenutzer oder einem anderen 
TRANSDATA-Kommunikationspartner einer 
Anwendung geschickt wird. Er endet mit der 
Antwort der Anwendung. 


UTM-Vorgang 


Anweisung an eine UTM-Anwendung, einen 
Vorgang durchzuführen. Er enthält 

einen Transaktionscode und ggf. zu 
verarbeitende Daten. Er wird von 
Datenstationsbenutzern, von UTM- 
Teilprogrammen derselben oder einer 
anderen Anwendung oder von anderen 
TRANSDATA-Kommunikationspartnern 
erteilt. 


Zeitraum, in dem ein Datenstations- 

benutzer, eine andere UTM-Anwendung 

oder ein TRANSDATA-Kommunikationspartner 
einer UTM-Anwendung bestimmte Aufträge 
erteilen kann. Er beginnt, wenn die 

Befugnis dazu erteilt wird. Er endet mit 
Rückgabe dieser Befugnis. 


Abarbeitung eines in sich geschlossenen 
Auftrags durch die Anwendung, die dazu 
eines oder mehrere Teilprogramme benutzen 
kann. Er kann aus einem oder mehreren 
Dialogschritten bestehen. Die Betriebs- 
mittel, wie Speicher usw., sind ihm 
zugeordnet. 


Digitales Rechensystem, das vorrangig der 
Verarbeitung von Datenin Anwendungs- 
programmen dient. 


Teilmenge der Komponenten des Datenfern- 
verarbeitungssystems, bestehend aus 
einem Datenstationsrechner und Daten- 
stationen. Es ist ein eigenständiges 
Teilsystem im Sinne der verteilten Ver- 
arbeitung (distributed processing). 
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Vorgang = Transaktion 
(transcation) 


Z 


Zeilen-Datenstation 
(line terminal) 
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Abarbeitung eines in sich geschlossenen 
Auftrags, den der Benutzer der Transak- 
tionsanwendung erteilt. Der Benutzer kann 
sein: 


— ein Datenstationsbenutzer 
— eine andere UTM-Anwendung 
— ein TRANSDATA-Kommunikationspartner. 


Der Vorgang kann aus einem oder mehreren 
Dialogschritten bestehen. Die erforderlichen 
Betriebsmittel sind dem Vorgang zugeordnet. 


Typ einer /ogischen Datenstation. Die 
Datenstruktur wird durch Zeilen gebildet. 
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Bestellung 


Bitte bestellen Sie Siemens-Druckschriften "Datentechnik” 


e als Kunde mit dem Bestellformular U1450-J-Z18-1. Sie erhalten es von Ihrem Ansprech- 
partner der zuständigen Zweigniederlassung bzw. Landesgesellschaft. Er wird Sie bei der 
Auswahl der Druckschriften gern unterstützen. 


e als Siemens-Mitarbeiter mit dem 


— Inland Bestellzettel S2000 (blau), bzw. 
— Ausland Bestellzettel S2002 (weiß). 


Richten Sie Ihre Bestellung bitte an: 


ZVW LAGER 
Postfach 1500 
8510 Fürth 


Bei der Bestellung geben Sie bitte die Bestellnummer vollständig an, damit der Ausgabestand 
der Druckschrift mit der bei Ihnen eingesetzten Produkt-Version übereinstimmt. Bestellnum- 
mern finden Sie in den Schriften: 


Datentechnik 
Druckschriftenverzeichnis 
Bestell-Nr. U500 


Datentechnik 
Druckschriften-Neuerscheinungen 


Das Druckschriftenverzeichnis erscheint zweimal jährlich und enthält die Bestelldaten aller 
verfügbaren Druckschriften aus dem Bereich Datentechnik. 

Die Einzelblätter "Druckschriften-Neuerscheinungen” informieren wöchentlich über neue 
Druckschriften. Sie enthalten die Bestelldaten und eine kurze Inhaltsangabe. Zur Ablage 
dieser Blätter gibt es einen Ordner mit einem Register nach Sachgebieten. Er hat die 
Bestellnummer U1050-J-Z18-1 und kostet 8,60 DM. 

Druckschriftenverzeichnis und “Druckschriften-Neuerscheinungen” erhalten Sie kostenlos 
und auf Wunsch regelmäßig. Sie können sich in den Verteiler aufnehmen lassen durch ein 
formloses Schreiben an: 


SIEMENS AG, D ÖA, Otto-Hahn-Ring 6, 8000 München 83. 


Änderungen von Manualen, die keine Neuausgabe erfordern, erscheinen als “Nachtrag” oder 
als kostenlose "Korrektur". Nachträge und Korrekturen werden ebenfalls über die “Druck- 
schriften-Neuerscheinungen” angekündigt und müssen bei Bedarf gesondert bestellt werden. 


Anstelle von Korrekturen wurden früher “Aktualisierungen” herausgegeben. Eine Aktualisie- 
rung müssen Sie nicht bestellen, wenn danach eine Korrektur oder ein Nachtrag erschienen 
ist. Die Aktualisierung ist in diesem Fall in die Korrektur bzw. den Nachtrag eingearbeitet. 


Musterbestellungen finden Sie auf den folgenden Seiten. 


Musterbestellung Kunde 


Sie benötigen die Druckschritt 
"COB1 Beschreibung” auf dem Stand der Produktversion 2.1. 


Auszug aus dem Druckschriftenverzeichnis: 


COB1 COBOL-Compiler, SW-Produkt BS1000, BS2000 


Tabellenheft (V1.11) D 15/5774-01 1105 
Beschreibung (V1.30) D 15/5453-02 6970 
Nachtrag (V1.30) D 15/5453-03N1 3945 
Tabellenheft (V1.11) D 15/5774-01 1105 
Beschreibung D 15/5453-02 6970 
Nachtrag D 15/5453-03N1 3945 
Nachtrag D 15/5453-04N2 1785 
Nacht: D O5N3 0190 
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0000 

3050 
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+ 0000 


Bestellung 


über D-Druckschriften und -Formulare 


Lieferanschrift: 


Siemens AG 
Zweigniederlassung 
Vertrieb Datentechnik 


Firma 


StraBe/Postfach Bearbeiter 
StraBe 


PLZ 


Bestell-Zeichen: 


Hiermit bestellen wir aus dem Siemens-Druckschriftenverzeichnis Datentechnik zur Lieferung an oben genannte 
Anschrift: | 


Pos] Besten i kurze =| Menge] Einzelpr.DM| Gesamtpreis DM _ 

Tree oe ee ae ee ee ee 

Roki re ee 

ooo 343-J3-755-4 Ce 1 Boda ae O 1 Beschreibung ee oe, o 
ee ee 


oe EEE 
i Me AN 


Ort, Datum 


Bestell-Nr. U1450-J-Z18-1 Firmenstempel und Unterschrift 


Musterbestellung SIEMENS-Mitarbeiter (Inland) 


Sie benötigen die Druckschrift 
"Generierung eines Datenkommunikationssystems” für BS2000 V7.1, PDN V7.0. 


Auszug aus dem Druckschriftenverzeichnis: 


Generierung eines Datenkommunikationssystems 
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DIP (distribution parameter block): Steuerblöcke 
DLL (Dienstprogramm) 4-20 


Dokumentation 2-13 
Doppelsystem 1-7 
DTH (Dialog- Testhilfe) 4-23 
dynamisch erzeugen 
- Namen (Adressen von 
Kommunikationspartnern) 2-3 
- Steuerblöcke 4-4 
dynamisch zuweisen: Namen-Zuweisung 
dynamischer Arbeitsbereich 2-13 


EID (event item identifier): Kennzeichen 
Empfangen 

- als Funktion von DCAM 3-28ff 

- im Programmablauf 2-14 

- mit Senden kombiniert 3-31 
Empfangsfeld der Nachricht 3-29 
empfängerglobale Warteschlange: Warteschlange 
ENAEI-Makroaufruf 4-6 
ENACO-Makroaufruf 4-7, 4-11 
ENB (event notification block): Steuerblöcke 
Ende einer Nachricht 2-17 
ENTER-Datei 4-23f 
Ereignis 

- allgemein 2-9 

- asynchrone DCAM-Meldungen 

- asynchrone Ausführung eines Befehls 

- Definition 4-6 
Ereignisinformation 4-8 
Ereigniskennzeichen 3-28, 4-6 
Eröffnen der DCAM-Anwendung 
Erzeugen der DCAM-Anwendung 
Existenzfunktion 3-1ff 
Expreßnachrichten 2-10, 4-11 
EXPR: asynchrone DCAM-Meldung 


Fehler 

- korrektur 2-10 

- routine 2-15 

- überwachung 2-10 
Fifo-Prinzip (first in first out) 2-7, 3-33 
Format-Darstellung 2-12 
Format-Datenstation 

- allgemein 2-20 

- Verwendung 3-15 
Formatsteuerung: Format-Datenstation 
FORM-Schnittstelle: Format-Datenstation 
Fremdanschluß: /ogische Verbindung 
FHS-Struktur 4-15 


Gemeinsamer Speicherbereich: Common Memory 
Generierung des Datenkommunikationssystems 2-2f 
Gerätetyp und -zustand 3-27 

Gesicherte Prozeduren 2-10 

Grenzwerte A.2 

Groß- und Kleinschreibung 2-21 

Gruppen von Prozessen 2-2 


Hardcopy-Gerät 2-20 
Hardwarebausteine oder -spektrum 1-5 


Identifikation der Nachricht: Laufnummer 
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impliziter Verteilcode 2-9 
Inter-Prozeß-Kommunikation (IPK) 4-15 
ISAM SHARED UPDATE 4-15, 4-22 


Kapazitatsverteilung 2-10 
Kennwort 

- allgemein 2-9, 2-13 

- Angabe bei YOPEN 3-3 

- Angabe bei YOPNCON 3-14 

- dynamische Festlegung 3-35 

- für Anschluß Sekundärprozeß 2-17, 3-3 

- für Zugriff auf Dateien 2-13 

- Vorgabe bei YOPEN 2-13, 3-2f 
Kennzeichen 

- des Ereignisses (EID) 3-25, 4-6 

- der Contingency (COID) 4-7, 4-11 

- der DCAM-Anwendung (AID) 4-4f 

- der Verbindung (CID) 3-22 

- verwenden 4-4 
Kommandomodus 4-23 
Kommandos 

- /APPLICATION 3-34 

- /BCIN 3-11 

- /BCLOSE 3-7 

- /BCTIMES 3-10, 4-11 

- [CANCEL 4-24 

- [CONNECTION 3-34 

- [LOGOFF 4-24 

- [SHUTDOWN 3-7, 4-24 
(Kommunikations-)Partner 

- allgemein 2-2, 3-2f 

- beliebiger (ANY) oder spezifischer 

(SPEC) 3-10, 3-20, 3-30 

- Datenstation 

- DCAM-Anwendung 

- PDN-Anwendung 

- UTM-Anwendung 
Kommunikationsrechner 1-5 
Kommunikationssystem: 
Datenkommunikationssystem 
Kommunikations-Zugriffsmethode (DCAM) 1-1 
Kommunikations-Zugriffssystem (DCM) 

- allgemein 1-1 

- Rolle beim Verbindungsaufbau 3-16 

- Ubermittler der Nachricht 3-24 

- Verwalter der DCAM-Anwendung 2-2 
Konfliktfalle: Datensicherheit 
Konstantenteil eines Programms 2-13 
Koordinierung der Zusammenarbeit 2-12 
Kopflangenbyte 3-27 


Lange der Nachricht 

- beim Empfang 3-29 

- beim Senden 3-25 

- maximale A2-2 

- ubermittelte 3-29 
Laufnummer der Nachricht 3-25, 3-30f 
Ladezeiten 4-13 
Lebensdauer eines Aufrufs 4-8 
LEVCO-Makroaufruf 4-11 
Lichtgriffel 2-17 
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LMR (Dienstprogramm) 4-20 
logisch(e) Datenstation 

- Benutzung beim Senden 3-26f 

- Stellung im TRANSDATA 1-1 

- unterstutzte Gerate 1-8 

- Format-Datenstation 

- Zeilen-Datenstation 
logische Netzadresse: symbolische Adressierung 
logische(r) Verbindung 

- Abbau 3-23 

- Abbruch 2-14 

- abzustimmende Eigenschaften 3-13f 

- allgemein 2-5 

- Aufbau 3-8ff 

- Beschreibung der Eigenschaften 3-13ff 

- Kennworte 

- Kennzeichen (CID) 4-5 

- Namen-Zuweisung 3-34 

- Verknüpfung mit einem Prozeß 2-6 

- Zugriffsschutz vor Fremdanschluß 2-9 

- Zuordnung der Speicherkapazitaten 2-10 

- zwischen Kommunikationspartnern 2-2 
logische Zeile: Zeilen-Datenstation 
LOGOFF-Makroaufruf 4-24 
LOGON: asynchrone DCAM-Meldung 
LOSCON: asynchrone DCAM-Meldung 


Makroaufrufe an DCAM 

- auf ACB bezogen 4-1 

- auf RPB bezogen 4-2f 
Maximalwerte: Grenzwerte 
MAXLN 
Mehrkonsolbetrieb (UCON) 1-1 
Mehrfachzugriff auf Dateien 2-13 | 
Meldung: asynchrone Meldung 
mittlere Zwischenankunftszeit 2-16 
Modalitäten der Datenübertragung 2-5 
Monopolisierung des Speichers 2-10 


Nachricht 

- Blockung 3-27 

- Code der Nachricht 3-14 

- empfangen 3-28., 3-31 

- Empfangsfeld 3-29 

- maximale Länge A2-2 

- Priorität 2-11 

- Quittierung 2-10 

- Sendefeld 3-24f 

- senden 3-24ff, 3-31 

- Teilnachricht 3-25, 3-27 

- zu lange Nachricht 3-13, 3-29f 

- Zuordnung der Nachricht zum Prozeß: 

Nachrichtenverteilung 

Nachrichtenaufbereitung 

- ändern 3-23 

- bei der Ausgabe 3-25f 

- festlegen 3-15 

- logische Datenstationen 
Nachrichtenkopf 3-27 


Nachrichtenverteilung 
- Arten 2-6ff — 
- Einstellung bei YOPNCON 3-14, 3-16f 
- Einstellung bei YRECEIVE 3-27f 
- Einstellung bei YSEND 3-24f 
Name 
- der DCAM-Anwendung: Anwendungsname 
- des Kommunikationspartners 2-3f, 3-11f 
- des Prozessorknotens 2-3f, 2-14, 3-11f 
Namen-Zuweisung 3-34f 
Netz 
- administrator 2-2 
- knotenrechner: Kommunikationsrechner 


Organisationsprogramm 2-13 


PAM SHARED UPDATE 2-13, 4-15, 4-22 
Partner: Kommunikationspartner 
Partnername: Name des Kommunikationspartners 
PDN-Anwendung 2-22 
physikalische | 
- Adresse: symbolische Adressierung 
- Datenübertragung 
- Leitung 3-27 
"physikalische” Programmierung von 
Datenstationen 2-12, 2-17 
Planung des Programmaufbaus 2-12ff 
positive Transportquittung 
Prädialog 4-23 
Primärprozeß 
- allgemein 2-2, 2-12 
- Aufgabe 2-16 
- Empfänger nicht zustellbarer 
Nachrichten 2-9, 3-32 
- Empfänger von asynchronen Meldungen 4-10 
- Empfänger von Transportquittungen 2-10 
- schließen einer DCAM-Anwendung 3-7 
Priorität von Nachrichten 
PROCON: asynchrone DCAM-Meldung 
Programm | 
- allgemein 1-3, 2-1 
- DCAM-Programm 
Programmodus 3-34, 4-24 
Programmspeicher 2-1 
Programmsteuerung 2-9 
Programmsystem 
- allgemein 2-13f 
- Prozeß-Gruppe 
Prozeduren 2-10 
Prozeß 
- allgemein 1-3, 2-1 
- DCAM-Prozeß 
- Dialogprozeß 4-23 
- Primärprozeß 
- Sekundärprozeß 
- Stapelprozeß 4-23f 
- Verknüpfung mit logischer Verbindung 2-6 
Prozeßgruppe 
- allgemein 2-2 
- Datensicherheit 2-10 
- DCAM-Anwendung, mehrfach benutzbare 


Prozessor 

- knoten des Partners 3-12, 3-16 

- name: Name des Prozessorknotens 
Prozeßverwaltung 4-5 
P1 Eventing und Contingencies 2-12f 


Quellcode-Datei 4-18 
Quittung: Transportquittung 


Reaktion des Kommunikationspartners 4-5 
RDF-Kennwort 2-9, 3-2ff 
Rechner-Rechner-Verkehr: Verkehrsbeziehungen 
Reentrant- 

- fähige Assembler-Programme 4-13 

- fahige COBOL-Programme 4-19ff 

- Steuerung 2-12 
Registerinhalte 

- Anstoß einer Contingency 4-15 

- Rückmeldung 
Route im Netz: logische Verbindung 
RPB (request parameter block): Steuerblöcke 
Rückinformation 

- nach Annahme einer Aufforderung 3-18 

- nach Ausgabe einer Aufforderung zum 

Verbindungsaufbau 3-16 

- nach Empfang einer Nachricht 3-30 
Rückmeldung 

- allgemein 2-15 

- COBOL 4-18 

- FDBK (Assembler) 4-9 
Rücknahme einer Aufforderung 3-22 
Rückstau 2-11, 3-25 


SECOND 4-10, 4-12 
Segmentierung 4-19 
Seitenwechselrate 2-13, 4-13 
Sekundärprozeß 

- allgemein 2-2, 2-12f 

- Anschluß an Prozeßgruppe 2-9 

- Aufgabe 2-17 

- Empfänger von asynchronen Meldungen 4-10 

- Empfänger von Transportquittungen 2-10, 3-30f 
Senden von Nachrichten 

- allgemein 2-14, 3-24ff 

- mit Empfangen kombiniert 3-31 
Sendefeld der Nachricht 3-24f 
Serialisierung 2-12 
SHARED CODE (D) 

- Assembler-Programme 4-13 

- COBOL-Programme 4-19ff 

- Programmplanung 2-13, 2-16 

- Verteilcode-Verwendung 2-7, 3-32 
SHARED UPDATE: PAM, ISAM 
Sicherheit der Datenübermittlung 

- allgemein 2-5 

- Datensicherheit 
Sicherheitskonzept 2-9ff 
Signal 3-28 
SOLSIG-Makroaufruf 4-6 
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Speicher 

- auslastung 2-13 

- bereiche 2-12 

- kapazität: logische Verbindung 
Standverbindung 1-6, 3-15 
Stapelfernverarbeitung 1-1f 
Station 

- allgemein 2-3 

- Datenstation 
Statusabfrage 4-17f 
sternformiges Netz 1-3 
Steuerblöcke 

- allgemein 4-1 

- dynamische Erzeugung 4-4 

- statische Erzeugung 4-3 
steuernder Prozeß: Primärprozeß 

_ Steuerung (des Programms) 2-9 

Struktur der Nachricht 3-27 
symbolische Adressierung 2-3f 
synchrone Ausführung eines Befehls 

- allgemein 2-9, 4-5, 4-18 

- bei YOPNCON 3-17f 

- bei YRECEIVE 3-29, 4-5 
Systemanwendung 1-3 


TACK: asynchrone DCAM-Meldung 
Taskattribut 4-23f 
Teilhaberbetrieb 1-1, 2-12, 4-15 
Teilnachricht 3-25, 3-2 
Teilnehmer 

- betrieb 1-1f 

- des Datenkommunikationssystems 2-2 
TERMJ-Makroaufruf 4-24 
Testphase bei der Programmerstellung 1-3 
TRAITS-Anweisung (LMR) 4-19 
TRANSDATA DCM: 
Kommunikations-Zugriffssystem 
Transportquittung 

- allgemein 2-10, 2-13, 3-4 

- Empfang 3-28 
Typ der Nachricht 


UCON (universal consol support): 
Mehrkonsolbetrieb 
Überlagerungssegment (overlay) 4-19 
user switches: Benutzer-Schalter 
USEPW 3-2ff 

UTM-Anwendung 2-22 


Verarbeitung 
- Beschleunigung der Verarbeitung 4-5 
- von Daten 2-13 
Verarbeitungslogik 3-3 
Verarbeitungsrechner 
- Datenübernahme innerhalb/von anderen 2-12 
- Hardware 1-5 
- Ort der DCAM-Anwendung 2-2, 2-9 
Verbindungsaufbau 
- Aufforderung zum Verbindungsaufbau 
- Prozedur des Verbindungsaufbaus 3-8 
- von der Datenstation A3-1f 
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Verbindungsfunktion 
- allgemein 3-8ff 
- logische Verbindung 
Verbindungsnachricht 
- bei Aufforderung zum Verbindungsaufbau 3-16f 
- Zugriffschutz 2-9 
V(erbindungs)-Struktur: 
Verkehrsbeziehungen 1-3f 
Verknüpfung logische Verbindung mit Prozeß 
Verteilcode 
- Beschreibung 3-19ff 
- Grenzwerte 
- impliziter 
- Steuerung 3-32ff 
- Warteschlange 
verteilte Verarbeitungsleistung 1-3 
Verteilungsname 
- Benutzung 3-33 
- Definition 2-7, 3-4f, 3-35 
Verteilungs (VTLG)-Struktur: 
Datenstrukturen 
Verteilung von Nachrichten 2-6 
V-Konstante 4-19ff 
Vorgaben: Kennworte 
VTSU (virtual terminal support) 
- allgemein 1-1f 
- Logische Datenstation 


Datenstrukturen 


Wahlverbindung 3-16 
Warteschlange der ankommenden Nachrichten 
- absenderspezifische 2-6f 
- allgemein 2-12 
- einstellen von Warteschlangen 3-16, 3-18, 3-28 
- empfängerglobale 2-6f 
- verteilcodespezifische 2-7 
Warteschlange der eingehenden Aufforderungen 
zum Verbindungsaufbau 3-9ff 
Wartezeit 
- allgemein 3-28, 4-5 
- Ausnutzung der Wartezeit 4-6 
- maximale 4-5, 4-18 
Wartung (von Programmen) 2-13 
Weitergabe von Daten 2-12 


X.25-Schnittstelle 4-2 


YAPPL 2-15, 3-34 
YCHANGE 3-23 
YCLOSE 2-14, 3-7 
YCLSCON 2-14, 3-23 
YCONN 2-15, 3-34 
YDDACB 4-4, A-1 
YDDCCB 4-4, A-1 
YDDCUAPL 4-16 
YDDCUCON 4-16 
YDDCUCOM 4-16 
YDDCUDIS 4-16 
YDDCUWAI 4-16 
YDDDCG 4-4, A-1 
YDDDIP 4-4, A-1 
YDDENB 4-4, A-1 


YDDRPB 4-4, A-1 

YFORBID 3-33 

YGENCB 4-4 

YINQUIRE 3-8, 3-21f, 4-17f 
YMODCB 4-4f 

YOPEN 2-14, 3-1f 

YOPNCON ACCEPT 2-14, 3-17f 
YOPNCON ACQUIRE 2-14, 3-20f 
YPERMIT 3-33 

YRECEIVE 2-14, 3-29 
YREJLOG 3-22 

YRESET 3-31 

YSEND 2-14, 3-24 

YSENDREC 3-31, 3-24 
YSETLOG 3-6 

YSHOWCB 4-4f 

YTESTCB 4-4 

YWAIT 4-16 


Zeilenanfang 3-26 
Zeilen-Datenstation 


- allgemein 2-17 

- Verwendung 3-26 
zeilenweise Ausgabe 2-12 
Zugriff 

- auf Datenstationen _ 

- auf Warteschlangen 
Zugriffs 

- methode: DCAM 

- schutz 2-9, 2-13 

- system: Kommunikations-Zugriffssystem 
Zuordnung des Verteilungsnamens zur 
Verteilcodegruppe 3-33 
Zurücknehmen von asynchronen 
Empfangsaufrufen 3-31 
Zurückweisung einer Verbindungsaufforderung 3-22 
Zustände einer DCAM-Anwendung 3-6 
Zwischenankunftszeit 2-16 
Zwischenspeicherbereich: 
logische Verbindung 
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